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Usage 


This product is intended for use only 
as described in this document. Control 


Data cannot be responsible for the 
proper functioning of undescribed 
features and parameters. 


Publication Number 60488613 


Manual History 


System Version/ Product 
Revision PSR Level Version Date 
A 1.2.1/670 1.0 December 1986 
B. 1.2.2/678 Le April 1987 
C 1.2.3/688 Le? September 1987 
D 1.3.1/700 1.3 April 1988 


This revision: 


Revision D documents SDF Version 1.3 under NOS/VE Version 1.3.1 at PSR 
level 700. It was published in April of 1988. This revision describes 
the redesign and new features associated with the CREATE, PROFIL, ZOOM 
and SEEDEF functions, reordering and renaming of function key 
assignments, describes the new ATTRIB feature, and new items on existing 
screens. Additionally, various editorial changes were made. 


Copyright 


©copyright 1986, 1987, 1988 by Control Data Corporation. All rights 
reserved. Printed in the United States of America. 


Limited local reproduction of this document is permitted for use within a & 


customer site providing Control Data Corporation is given acknowledgment 
for the original document. 


Control Data Corporation grants permission to modify this document 
according to local site requirements. The revised document must have an 
acknowledgment that it is based on a Control Data Corporation document, 
is protected by copyright, and cannot be made available for sale. 


Disclaimer 
This product is intended for use only as described in this document. 


Control Data cannot be responsible for the proper functioning of 
undescribed features or parameters. 
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About This Manual 


Audience 


This manual describes: how SDF works; how to use SDF editing functions 


to create and edit screens and perform other functions associated with 
Screens you create or edit. 


The manual is written for technical and non-technical users who are 
creating application programs written in FORTRAN, COBOL or CYBIL 
programming languages that will run in a full-screen environment. 


Organization 


This manual is organized to enable you to easily and quickly find the 
information needed to create and/or edit screens. The section titles and 
subsection titles are task oriented; for example, Defining Attributes. 
Each SDF presentation screen is presented and then the functions 
associated with the screen are described. 


Ordering Printed Manuals 


Control Data manuals are available from you local CONTROL DATA® office. 
Sites within the U.S. can also order manuals directly from Control Data 


Literature Distribution Services at the following address: 


Control Data Corporation 


Literature and Distribution Services 
308 North Dale Street 
St. Paul, Minnesota 55103 


Submitting Comments 


The last page of this manual is a comment sheet. Please use it to give 
us your opinion of the manual”s usability, to suggest specific 
improvements, and to report technical or typographical errors. If the 
comment sheet has already been used, you can mail your comments to: 


CONTROL DATA CORPORATION 

Technology and Publications Division 
P.O. Box 3492 

Sunnyvale, CA 94088-3492 


If you have access to SOLVER, the Control Data online facility for 
reporting problems, you can use it to submit comments about this manual. 
When SOLVER prompts you for a product identifier for your report, please 
specify "SD8" for the product identifier. 
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In Case You Need Assistance 


In Case You Need Assistance 


Control Data”s Central Software Support maintains a hotline to assist you 
if you have trouble using our products. If you need help beyond that 
provided in the documentation or find that the product does not perform 
as described, call us at one of the following numbers and a support 
analyst will work with you. 


From the USA and Canada: (800) 345-9903 
From other countries: (612) 851-4131 


The preceding numbers are for help on product usage. Address questions 
about the physical packaging and/or distribution of printed manuals to 
Literature and Distribution Services at the following address: 


Control Data Corporation 

Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


or you can call (612) 292-2101. If you are a Control Data employee, call 
(612) 292-2100. 
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Introduction ] 


When building an application program in FORTRAN, COBOL or CYBIL, the 
application developer can provide a full-screen environment for the end 
user of the application. In a full-screen environment, the end user is 
presented with screens that look like paper forms (such as a tax form, 
invoice or order form) that are used in non-computer related activities 
to record and receive information. As with a paper form, the items on a 
screen are organized for quick recognition and response by the user. For 
example: 


EMPLOYEE INFORMATION 


Name: Birthdate: 
Home address: 

City, State: 

Zip Code: 


Hire date: 

Job title: Grade: 

Dept. number: Facility: 
@ Division name: 


Salary: Exemptions: 


The Screen Design Facility (SDF) is one of the tools that can be used to 
provide a full-screen environment. 


SDF is an easy to use, interactive tool the application developer uses to 
create, modify and maintain the display and data entry screens that are 
presented to the end user of the application. 


The other tool, Screen Formatting, is a set of subroutines and procedures 
that manage the screens in the application program. For example, you use 
Screen Formatting to display and remove the screens from the application 
users screen. To provide a full-screen environment for an application, 
the application developer includes calls to the procedures or subroutines 

@ in the application program. For more information, please refer to the 
Screen Formatting Usage manual. 


Revision D Introduction 1-1 


Introduction 


A screen created by SDF can contain fields made up of: @ 


r) Constant text, such as titles, menus, instructions, and column 
headings. 


e Variables and tables made up of variables into which the application 
user can input data or the application program can output data. & 


e Lines and boxes used to identify where data can be input or output, 
frame a screen, decorative purposes, and so forth. 


For any type of field you enter on a screen, you can define various 
highlighting (such as inverse video, blinking, and underlining). For 
variables and tables you can define other attributes (such as type of 
data, how data can be input or output, and maximum number of characters). 


SDF also provides a wide variety of editing functions that enable you to: 


® Specify characteristics to be associated with the screen, such as, 
type of programming language that will access the screen, screen 
width and height, and where the screen will be located on the users 
terminal screen. 
@ Move, copy, center, erase and define fields on a screen. 
e Display, save and delete screens. 
@ Assign function keys for the screen. 
@ Assign attributes for the entire screen. These attributes can be © 
used dynamically by the application program for special cases, such 
as highlighting a field when erroneous data is entered. 


In addition to creating and editing screens in SDF, you can also: 


Learn to use SDF by accessing the online manual from SDF. 
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SDF Overview 


SDF Overview 


SDF is organized as a hierarchy of screens. On each screen presented, 
you make choices to perform the various functions available for creating 
and editing a screen. Depending on the choices you make, you are taken 
through a particular path of the hierarchy of screens. 


The choices are displayed in the form of function key prompts at the 
bottom of the screen or a list of items (such as a list of screens). 
Instructions on each screen tell you how to make choices on the screen. 
Your choice is communicated to SDF by pressing a function key or by 
positioning the cursor next to an item and pressing a function key. 


At anytime during an SDF session, you can return through the hierarchy of 
screens and retrace the path you have taken. On any screen in the return 
path, you can make new choices if desired. An example of taking one path 
through the hierarchy is shown below. 


Help is available for virtually every item and function key displayed on 
an SDF screen. Three levels of help are available. The first level is a 
short reminder of the meaning of the item; the second level is a more 
detailed explanation of the meaning of the item; the third level accesses 
the online manual location where the item is described in detail. 


After accessing SDF, you are presented with the SDF Banner screen. From 


this screen you select the type of session to be initiated. The Banner 
screen is shown below: 


NOS/VE SCREEN DESIGN FPACILITY 
Version 1.3 


Choose the first activity you wish to perform 


Press LEARN to learn how to use SDF 
Press EDIT to create or edit a screen 
Press HELP to get help with this screen 
Press QUIT to exit SDF 


The LEARN session takes you to the SDF Online Usage manual which provides 
you with information about how to use SDF. 


The EDIT session is the entry point for creating and editing screens. 
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SDF Overview 


For this example, you want to create a new screen, so you choose EDIT on 
this screen. The next screen presented is the Select screen. 


SDF 
->SELECT 


NOS/VE SCREEN DESI 


SELECT SCREEN 


APPLO9 
Departmental Payroll Screen 
HELPER 

INITFORM 

SCREEN 1 

SCREEN 11 

SCREEN12 

TEST-SCREEN 

Employee Information 

Salary History 


Tab or position cursor to select a screen 
Press key for function desired 


On this screen you can choose to: 

@ CREATE a new screen. 

e SELECT an existing screen for editing. 

e SHOW or DELETE an existing screen. 

e UNDO a previous DELETE function. 

® QUIT the SDF session and return to NOS/VE. 

® Display and change the profile of an existing screen (PROFIL). 

For this example, you will choose CREATE on this screen. When you create 


a new screen, the Define Screen Profile screen is displayed automatically 
for defining the screen characteristics. 
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SDF Overview 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT DEFINE ATTRIBUTES 
->PROFIL 


Attribute Value(s) 


Programming Language: —cobol ansi fortran CDC fortran cybil 
Background color: _black blue green magenta red cyan yellow white 
Foreground color: black blue green magenta red cyan yellow white 


Screen border: "fine _medium bold _none 
Screen width: 


Screen height: 
x~origin: 
y~origin: 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 


On this screen, you enter the characteristics for the screen you are 
going to create, such as, the programming language of the application 


accessing the screen, background and foreground color, height and width 
e@ of the screen and the position the screen will occupy on the end users 
terminal screen. 
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SDF Overview 


When the screen profile is completed, a blank screen called the User Edit 
screen is displayed next. 


Unmark Erase Sel Copy NoKeys Ruler 
FliMark [F2|Define|F3| Draw |F4] Move [F5 F6] Quit [F7] Toggle |/F8iCenter 


On this blank screen, you enter the fields that make up the screen you 
are creating. You can use the editing functions displayed at the bottom 
of the screen to: define attributes for the fields you enter, such as, 
type of data and highlighting; copy, move, center or erase fields; assign 
function keys for the screen; and perform other functions related to the 
screen you are creating. Depending on the editing functions you select, 
more screens in the hierarchy may be presented. 


The screen you are creating can be any size desired; the maximum size is 
the size of the terminal display you are using or 80 columns, whichever 
is less. The minimum size is 1 row 1 column, 


The size flexibility enables you to design multiple screens for display 
on a user’s terminal screen at the same time. When creating multiple 
screens, each screen must be defined separately. The screens can then be 
displayed in any order by the application program. 


As you progress in creating or editing a screen, the effects of your 
actions are immediately visible. When you finish, you can exit, save the 
new or changed screen and/or start another SDF activity. 
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SDF Conventions and Rules 


SDF Conventions and Rules 


SDF Screen Layout 


As you use SDF, you are presented with screens that look very much like 
the screen shown below. The items shown with arrows represent 
conventions that appear on all SDF presentation screens. 


Context Block Screen Title 


NOS/VE SCREEN DESIGN FACILITY 
Version 1.1 


Choose the first activity you wish to perform 


Press LEARN to learn how to use SDF 
Press EDIT to create or edit a screen 
Press HELP to get help with this screen 
Press QUIT to exit SDF 


ofa] oe] 


Instructions Function Key Prompts 


Descriptions of these conventions are provided below. 


Command Line 


On all screens presented during an SDF session, a command line is 


provided for entering and executing NOS/VE SCL commands while in the SDF 
environment. 


On most terminals, pressing the HOME key positions the cursor on the 


command line which is normally line 1 on the screen. SCL commands are 
entered on this line. 


On terminals that do not have a labelled HOME key, you must use the 


cursor control keys on your terminal to move the cursor to the command 
line. 
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SDF Screen Layout 


When creating or editing a screen, a function key is provided for SCL 
command entry in order to make the home line area available to the screen 
designer. 


Context Block 


The context block provides a dynamic record of the path you have taken in 
the hierarchy of SDF screens to arrive at the screen currently displayed. 


The context block is located in the upper left corner of each SDF screen. 


Your present location in the SDF hierarchy is indicated by an arrow to 
the left of the list. For example, the following indicates you are 
currently in an editing session: 


SDF 
~>EDIT 


Screen Title 


The screen title, located at the top center of each screen (except on a 


screen you are editing or creating), is the name of an SDF screen. The 
screen title is always in capital letters. The following is a list of 
SDF screen titles and a short description of the screen. 


BANNER 


This is the first screen presented; you choose the type of 
session on this screen (LEARN or EDIT). 


SELECT 


This screen is presented when you select an EDIT session from the 
Banner screen. On this screen you can select to create a new 
screen, select an existing screen for editing or perform other 
functions pertaining to a selected screen. 


DEFINE SCREEN PROFILE 


When you use the CREATE function to create a new screen, this 
screen is displayed automatically for defining the screen 
profile. To access this screen to change an existing screen 
profile, position the cursor next to the name of a screen on the 
Select screen and press the PROFIL function key. 


USER EDIT SCREEN 


The User Edit screen is displayed when you select an existing 
screen for editing or select to create a new screen. When you 
select an existing screen for editing, the selected screen is 
displayed. When you choose to create a new screen, the Define 
Screen Profile screen is displayed first. After completing the 
screen profile, the User Edit screen is displayed blank. You 
create your new screen on this blank screen. 
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SDF Screen Layout 


In either case, the User Edit screen is displayed with the 
editing functions represented as function key prompts at the 
bottom of the screen. There are two sets of function key prompts 
available. You can toggle between the two sets of keys to use 
the editing functions necessary to accomplish your editing. 


DEFINE ATTRIBUTES 


This screen is presented for defining attributes for a field on a 
screen you are creating or editing. There is a different Define 
Attributes screen for each type of field you can enter ona 
screen. They are: constant text, character variable, numeric 
variable, table, box or line. You specify the type of field, and 
the appropriate screen is displayed. 


DEFINE ATTRIBUTE GROUPS 


This screen is displayed when you use the secondary editing 
function ATTRIB on the User Edit screen. The screen is used to 
define attributes for a screen. These attributes are saved with 
the screen definition and will be available for dynamic use by 
the application program using the screen. For example, the 
application program can access these attributes when it is 
necessary to show dynamic highlighting for error cases. 


DEFINE FUNCTION KEYS 
This screen is presented for assigning function keys for the 
screen you are creating or editing. 
System Name 


Specifies the name of the system and the version number. 


Instruction Lines 


Instruction lines tell you how to use or process information on a 
screen. For example, 


Tab or position cursor to select a screen 
Press key for function desired 


On most SDF screens, instruction lines are located at the bottom of the 


screen. In some cases, instruction lines are located above a list of 
choices displayed on the screen. 


Function Key Prompts 


When function keys are active for a given screen, the logical meanings 
and assignments are displayed as one or more rows of function key prompts 
at the bottom of the screen. For example: 
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Using an Imaginary Box 


Function key prompts indicate the different functions you can perform by 
pressing the corresponding function key. On some screens, two functions 
are listed for each function key. To initiate a function listed on the 
upper line, you must use the uppercase SHIFT key on your terminal. The 
lower line functions are initiated in an unshifted mode. 


Note that on different terminals, the location of specific function key 
assignments may vary. 


If you press a function key that is not active for the screen you are 
using, the following error message is displayed: 


~~ Key has no meaning for cursor position. 


To remove the message from the display, press the BACK key. 


Using an Imaginary Box 


When using many of the SDF editing functions, the area on the screen to 
be edited must be identified before the editing function can be 
performed. SDF uses a convention of an imaginary box to identify the 
area to be edited. 


An imaginary box is temporarily created by marking the area to be 
edited. SDF provides a MARK function key for this purpose. 


When you create an imaginary box, you mark two opposing corners of a 
rectangle enclosing the area to be edited, for example, upper left corner 
and the lower right corner. 


Areas on the screen that have already been defined are marked by 


positioning the cursor anywhere on the area and pressing the MARK 
function key. 


To perform an editing function on multiple fields, whether defined or 
undefined, you must mark an imaginary box around the fields; encompassing 
the width and height of the area you wish to edit. 


An imaginary box is shown highlighted on your screen. The memory of of 


an imaginary box lasts until it is moved, erased, defined, another field 
is marked, or until the area is UNMARKed. 
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Terminal Keys 


When using SDF, some terminal keys are necessary to perform certain 
functions, such as paging and scrolling. 


Some of these keys are present on all terminals, while others may NOT be 
present as labelled keys on a terminal being used for an SDF session. 
When these keys are not present on the terminal in use, they are, in some 
cases, assigned to function keys and are represented as function key 
prompts at the bottom of the screen or defined as a special sequence of 
keys you press. The keys are: 


NEXT 
BACK 
HELP 
HOME 
FWD 
BKW 
UP 
DOWN 


These keys are described below: 
NEXT Key 
Pressing the NEXT key signals the completion of an activity. 


The NEXT key (RETURN or NEW LINE key on some terminals) is 
present on all terminals and is never represented by a function 
key prompt. 


BACK Key 


Pressing the BACK key means return to the previous context (as 
indicated by the context block in the upper left corner of the 
screen). 


If the BACK key is not present on your terminal, it is 
represented by a function key prompt at the bottom of the screen, 
or defined as a special sequence of keys you press. 


If you press the BACK key after making editing changes on a 
screen and you have not saved the screen, SDF offers you a chance 
to do so by displaying the following message: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran _cde fortran _cybil 


Press the NEXT key to replace an existing screen to which you 
have made changes. Enter a unique name and press NEXT to save a 
new screen, press the BACK key to discard the screen, or press 
QUIT to exit SDF (the screen will also be discarded). 
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Terminal Keys 


L=12 


The line at the bottom of the overlay is provided for indicating 
the programming languages for which you want a record definition 
generated for the screen. The language checked is the language 
specified when you defined the screen profile. You can enter any 
character next to as many of the languages as desired. There 
will be one SCU deck generated for each language selected. If no 
languages are selected, no record definitions will be generated. 


HELP Key 


Pressing the HELP key calls the help facility regarding the item 
where the cursor is positioned. 


If the HELP key is not present on your terminal, it is 
represented by a function key prompt at the bottom of the screen, 
or defined as a special sequence of keys you press. 


HOME Key 


FWD 


BKW 


Pressing the HOME key moves the cursor to the command line on the 
terminal. When the cursor is positioned on the command line, you 
can enter and execute NOS/VE SCL commands while in an SDF session. 


The command line may be at the top or at the bottom of the 
terminal display depending on the terminal model. 


If the HOME key is not present on your terminal, you must use the 
cursor control keys on your terminal to move the cursor to the 
command line. 


Key 


Pressing the FWD key means page the text at the cursor position 
forward one logical page. For example, when the list of screens 
shown on the Select screen exceeds one page, the FWD key is used 
to page forward to see the next page of the list. 


If the FWD key is not present on your terminal, it is represented 
by a function key prompt at the bottom of the screen. 


Key 


Pressing the BKW key means page the text at the cursor position 
back one logical page. For example, after paging forward with 
the FWD key, the BKW key is used to page back to the previous 


page. 


If the BKW key is not present on your terminal, it is represented 
by a function key prompt at the bottom of the screen. 


UP Key 


The UP key moves the line where the cursor is positioned up to 
the top of the screen. 


If the UP key is not present on your terminal, it is represented 
by a function key prompt at the bottom of the screen. 
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DOWN Key 


The DOWN key moves the line where the cursor is positioned down 
to the bottom of the screen. 


If the DOWN key is not present on your terminal, it is 
represented by a function key prompt at the bottom of the screen. 


Using the Help Facility 


Help is available for every SDF screen and for virtually every item and 
function key prompt displayed on the screen. 


To get screen or item help, position the cursor on the screen name, a 
blank space on the screen, or on a specific item on the screen. Then 
press the HELP key. 


To get function key help, you must press the HELP key to enter the Help 
Facility. Then press the function key for which you want help. 


Three levels of help are available: 


First level - 
Press the HELP key once; a one line reminder of the meaning of 


the item, function key or screen is displayed at the bottom of 
the screen. For example: 


MARK — Remember cursor position to identify item, box or line. 


Press HELP for more help, F-key for key help, NEXT to exit help 


Second Level - 
Press the HELP key a second time; a more detailed explanation of 
the item, function key or screen is displayed at the bottom of 
the screen. For example: 


MARK — Remember cursor position to identify item, box or line. 
An item, box or line may be marked and copied or moved with its attributes. 
Draw a box after making two non-adjacent corners. 


Draw a line by marking its beginning and ending characters. 
Mark an imaginary box to copy, move or erase an area of the screen. 


Press HELP for more help, F-key for key help, NEXT to exit help 
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Third Level - & 
Press the HELP key a third time; you are taken out of SDF to the 
online manual for complete information about the item, function 
key or screen. 


In the online manual, the help information is displayed on the 
whole screen, and you must use the online manual instructions for 
paging through the manual. 

To return to SDF from the online manual, enter the following: 


QUIT 


When the first and second levels of help are displayed for a screen, item 
or function key, you can: 


@ Position the cursor on another item and press the HELP key for help 
with that item. 


e Press another function key for help about that function. 


@ Press the NEXT key to exit the Help Facility and return to what you 
were doing before entering the Help Facility. 


When you request the third level of help, you enter the online manual. 
When in the online manual you cannot request additional help. You can 


only page through the manual, or enter QUIT to return to SDF. 


Error Processing @ 


When you attempt to do something which is out of context or against the 
rules, SDF displays an error message on the screen. For example: 


--— MARK an area or entity before using DEFINE 


Press NEXT to return to SDF 


Press the NEXT key to delete the message. Depending on the nature of the 
message, you may want to try what you were doing again, or you may decide 
not to pursue what you were trying to do. 


NOTE 


Function keys are not operational when an error message is displayed. 


Pressing any function key will only clear the message from the screen and 
return to SDF. 
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Error Processing 


If you press a function key that is not active for the screen you are 
using, the following error message is displayed: 


-- Key has no meaning for cursor position. 


To remove the message from the display, press the BACK key. 
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Accessing SDF 2 


Terminal Requirements 


SDF uses the Terminal Definition Utility and Screen Formatting to control 
the terminal interface to the end user. For more information, please 


refer to the Terminal Definition Usage manual and the Screen Formatting 
Usage manual. 


To create, modify and maintain screens using SDF, the terminal must have 
a minimum of 24 lines of at least 80 characters per line, and 16 function 
keys. The function keys can be in the form of eight shiftable keys. 


Accessing SDF 


To begin an SDF session, you must login to the NOS/VE system, and type 
the following SCL command: 


DESIGN SCREEN or DESIGN SCREENS (DESS) 
LIBRARY=file 
MODE=keyword 
SCREEN _NAME=name 
SOURCE=file 
STATUS=status variable 


Parameters for the DESS command: 


LIBRARY(L) 


The file path to the object library to be used for this SDF 
session. All object screen modules for this SDF session are 
extracted from and/or placed in this library. The default 
library is SCREEN_LIBRARY in the current working catalog. The 


maximum number of screens that can be stored in your library is 
250. 


Note that the object library used by SDF can be maintained by the 
CREATE OBJECT_LIBRARY utility. 


MODE(M) 
MODE is the session mode (EDIT or LEARN). 
Use this optional parameter to bypass the SDF Banner screen and 


go directly to the session mode indicated by the keyword. If not 


specified, the session mode is selected by you from the SDF 
Banner screen. 
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SCREEN_NAME(SN) 
The name of an existing screen in your object library. 
This optional parameter causes immediate entry into an edit 


session with the named screen displayed. You bypass the Select 
screen from which you select a screen. 


NOTE 


The MODE parameter takes precedence over the SCREEN_NAME 
parameter. 


SOURCE(S) 


The file path to the file in which to write a record definition 


for any screen that is saved in the object library specified by 
the LIBRARY parameter. 


The record definition is a generated source code description of 
all the variables defined for the screen. The definitions are 
written in the programming language of the application using the 
screen. 


Each definition is in the form of a source text record that can 


be used as input for SCU. The screen name is used as the name of 
the deck. 


If you do not specify a complete file path, the record 
definitions are written to the file SCREEN SOURCE in the working 
catalog. 


NOTE 


Each time you save a screen, the record definition is appended at 
the end of the specified source file. You may have more than one 
record definition for a screen in the source file. If you leave 
the session and start another session, the source file is cleared 
and you can start over again. 


STATUS 


Optional status variable. 
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Accessing SDF Summary 


There are three ways to access SDF when you login with the DESS command. 


1. Enter the DESS command without the MODE or SCREEN NAME parameters. 
The SDF Banner screen is the first screen displayed at your 
terminal. From the Banner screen, you select the type of activity 
& you want to perform (LEARN or EDIT). 


2. Enter the DESS command with the SCREEN NAME parameter. You 
immediately enter Edit mode with the specified screen displayed at 
your terminal. You can begin editing the displayed screen. 


3. Enter the DESS command with the MODE parameter. If you enter 
MODE=EDIT, you immediately enter Edit mode with the Select screen 
displayed. From the Select screen you can choose to create a new 
screen, select, display or delete an existing screen, and perform 
other functions related to a selected screen. If you enter 
MODE=LEARN, you are taken to the online manual for help with SDF. 
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Choosing a Session Type (The Banner Screen) 


When you sign on to SDF, the SDF Banner screen is displayed first. 


NOS/VE SCREEN DESIGN FACILITY 
Version 1.3 


Choose the first activity you wish to perform 


Press LEARN to learn how to use SDF 
Press EDIT to create or edit a screen 
Press HELP to get help with this screen 
Press QUIT to exit SDF 


Description 


The Banner screen is.at the top of the SDF screen hierarchy. The 
type of SDF session is selected from this screen. 


To access the Banner screen: 


® Signon to SDF using the DESS command without the MODE or SCREEN NAME 
parameters, or 


e Return through the hierarchy using the BACK function key. 


The following functions are available on the Banner screen. Choose the 
type of session by pressing the appropriate function key. 


LEARN Enters the SDF Online Usage manual. 

EDIT Enters the SDF EDIT mode to create or edit a screen. 
HELP Displays text explaining the Banner screen. 

QUIT Ends the SDF session. 
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Banner Screen Functions 


The Banner screen functions are described below. 


Accessing the Online Manual 
(LEARN Function) 


The LEARN function exits SDF and enters the SDF Online Usage manual. The 
online manual provides detailed information about SDF. 


To initiate the LEARN function, press the LEARN function key. 

While you are in the online manual, you must follow the instructions for 
the online manual system to page through the manual. Please refer to the 
CONTEXT Usage manual. 


To come back to SDF from the online manual, enter the following: 


QUIT 


Getting Help With the Banner Screen 
(HELP Function) 


The HELP function provides an explanation of the Banner screen. 


To get help, press the HELP key. On terminals that do not have a 
labelled HELP key, the appropriate key to press is indicated by a 
function key prompt at the bottom of the screen. 


After you enter the Help Facility, you can press any function key and get 
help about that function. 


Press the NEXT key to clear the help message from the screen. 


Ending an SDF Session 
(QUIT Function) 


The QUIT function ends an SDF session and returns you to NOS/VE. 


If you press the QUIT function key from the Banner screen, or from the 
Select screen, you are immediately returned to NOS/VE. 


If you press QUIT after using an editing function on a new or existing 
screen, and you have not used the SAVE function, SDF offers you a chance 
to save the screen by overlaying the screen with the following message: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran _cde fortran _cybil 
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Press the NEXT key to replace an existing screen to which you have made 
changes. Enter a unique name and press NEXT to save a new screen, press 
the BACK key to discard the screen, or press QUIT to exit SDF (the screen 
will also be discarded). 


The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition generated 
for the screen. The language checked is the language specified when you 
defined the screen profile. You can enter any character next to as many 
of the languages as desired. There will be one SCU deck generated for 
each language selected. If no languages are selected, no record 
definitions will be generated. 


If you press QUIT and you have not used an editing function, the message 
is not displayed; the session is ended and the entries are discarded. 


Initiating an Editing Session 
(EDIT Function) 


The EDIT function on the Banner screen initiates an editing session. 
When you press the EDIT function key, the Select screen shown below is 
displayed: 


SDF NOS/VE SCREEN DESIGN FACILIT 


~>SELECT SELECT SCREEN 


APPLOY 
Departmental Payroll Screen 
HELPER 
INITFORM 
SCREEN1 
SCREEN 11 
SCREEN12 
TEST—SCREEN 


Tab or position cursor to select a screen 
Press key for function desired 
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Description & 


The Select screen is the entry to an editing session. From this 
screen, you can choose to create a new screen or select an existing 
screen for editing. You can also delete or display an existing 
screen, cancel a previous delete function and display and change the 


profile of an existing screen. rd] 


If you previously created screens using SDF, the Select screen 
displays a list of those screens. These screens can reside in the 
object library specified on the DESS command when you signed on to 
SDF, or if you did not specify an object library, a list of the 
screens that reside in your default library SCREEN_LIBRARY (in your 
working catalog) are displayed. 


The maximum number of screens that can be displayed in the list of 
screens is 12. If you have more screens than are displayed, the 
paging and scrolling keys can all be used to examine the list of 
screens. The paging and scrolling keys are: FWD, BKW, UP and DOWN. 
To access the Select screen, you can either: 
e Choose the EDIT function on the Banner screen. 


e Access SDF with MODE=EDIT on the DESS command. 


e Return through the hierarchy using the BACK function key. 


The following functions are available on the Select screen. Choose a 
function by pressing the appropriate function key. & 
CREATE Initiates the creation of a new screen. 
SELECT Selects an existing screen for editing. 
SHOW Displays the selected screen. 
DELETE Deletes a screen from the library. 
UNDO Cancels a previous delete function. 
QUIT Ends an SDF session. 
PROFIL Initiates changes to a selected screen profile. 


The functions on the Select screen are described below. 
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Creating a Screen 
(CREATE Function) 


The CREATE function is used to create a new screen. To create a screen 
two things are done: 


l. Define the screen profile. When you press the CREATE function key, 
the Define Screen Profile screen is automatically displayed. On this 
Screen you must specify the characteristics of the screen, which 
are: the programming language of the application that will access 
the screen, background and foreground color of the screen, the 
thickness of the screen border if applicable, the screen width and 
height, and the position that the screen will occupy on the end users 
terminal display. 


2. Design the screen. When you complete the screen profile, a screen 


called the User Edit screen is automatically displayed for designing 
and defining the fields that will appear on the screen. 


Defining the Screen Profile 


When you press the CREATE function key the first screen displayed is the 
Define Screen Profile shown below: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT DEFINE SCREEN PROFILE 
—>PROFIL 


Attribute Value(s) 


Programming Language: —cobol ansi fortran CDC fortran cybil 

Background color: _black blue green magenta red cyan yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
Screen border: _fine medium bold _ none 

Screen width: 


Screen height: 
x-origin: 
y-origin: 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
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To complete the items on the Define Screen Profile screen, enter any 
character next to your choice or enter the appropriate values on the the 
blank lines. If you do not want to enter values, you can: 


Use the SYSTEM function to apply the default screen characteristics 
to each item on the screen. 


Use the REPEAT function to apply the same characteristics that you 
specified for the previous screen you defined. 


Use the FINISH function when you have completed your entries. 


Use the CANCEL function to cancel the definitions for the screen. 
You are returned to the Select screen. 


items on the Define Screen Profile screen are described next. 


(OPTIONAL) 


Specify the programming language used for the application that 
accesses this screen. The default is Cobol. When you save the 
screen, SDF creates a source program record description in that 
language, and writes it to the file specified by the SOURCE parameter 
on the DESS command when you accessed SDF. The record description 
describes the data fields on the screen. The record description can 
be inserted in the application program for compilation as part of the 
program. 


Specify the color of the screen behind the lines and characters on 
the screen. Selected areas of the screen can have a different 


background color, if specific color attributes are specified for 
certain screen areas. 


Specify the color of the lines and characters displayed on the 
screen. Selected areas of the screen can have a different foreground 


color, if specific color attributes are specified for certain screen 
areas. 


3-6 


Specify the thickness of the lines that make up the border of the 
screen if a border is desired. The size of the border is determined 
by the values entered for screen height, width, x-origin and y-origin 
on this screen. When you define a border, you cannot design the the 
screen outside of that perimeter. Note that the border does not 
appear unless the SHOW function is used to look at the screen. 


(OPTIONAL) 
Enter the width of the screen, in columns. The maximum width is the 


width of the terminal you are using and is the default. The minimum 
width is 1 column. 
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(OPTIONAL) 


Enter the height of the screen, in lines. The maximum height is the 
height of the screen you are using and is the default. The minimum 
height is 1 line. 


(OPTIONAL) 


Enter the column on the end users terminal display that will be the 
left edge of this screen when displayed. The default is column l. 


Chey 


(OPTIONAL) 


The line number, on the end users terminal display, that will be the 
top line of this screen when displayed. The default is line l. 


If you want the size of the screen to adjust automatically to the size of 
any terminal on which the application is processed, leave screen height, 
width, x-origin and y-origin blank. The screen size will be variable and 
will adjust automatically according to terminal type. 


When values are entered for screen height, width, x-origin and y-origin, 
the screen size is set to the size specified. When the defaults are used 
for these definitions, the screen size is set to the size of the terminal 
you are using. In either case, the screen size will not adjust 
automatically to different terminal types. 


When you complete defining the screen profile, press the FINISH key. The 
definition is then processed and the User Edit screen is displayed. The 
User Edit screen is where you design the images that will appear on the 
screen you are creating. 


Designing the Screen 


When the screen profile is complete, the User Edit screen is displayed 
automatically. The User Edit screen is displayed with the editing 
functions shown as function key prompts at the bottom of the screen. You 
design the screen you are creating on this screen. 


If you specified the defaults on the Define Screen Profile screen, the 


User Edit screen is blank when displayed. You can design the screen 
anywhere on this blank screen. 


If the screen is defined to be smaller than the terminal screen you are 
using, the screen is still blank, however, the defined screen is 
displayed in column 1, line 1 with a horizontal and vertical line 
surrounding the area defined as the screen size. You can only design the 
screen within these lines. 


Revision D Creating and Editing Screens 3-/ 


Creating a Screen 


An example of a blank User Edit screen is shown next. 


Unmark Erase Scl Copy NoKeys Ruler 
FliMark |F2{|Define /F3| Draw |F4] Move |F5 F6] Quit |F7|Toggle |F8/Center 


Creating and editing screens is the major activity of an SDF session, and 
the editing functions are used to perform these two activities. 


Unmark Erase Scl Copy NoKeys Ruler 
FlijMark {F2|Define|F3]| Draw |F4] Move [F5] Undo |F6] Quit |F7]/Toggle |F8/|Center 


The functions shown above are the MAIN editing functions you see when the 
User Edit screen is displayed. The functions listed on the top line are 
initiated by pressing the SHIFT key and the indicated function key. 
Pressing the TOGGLE key displays the SECONDARY editing functions. 


Scl 


Pressing the TOGGLE key again will display the MAIN editing functions 
again. To use an editing function, it must be displayed at the bottom of 
the screen. 
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The editing functions are briefly described next. Detailed descriptions 


are provided later in this manual. 


ATTRIB Defines dynamic attributes for the entire screen. 
CENTER Centers a field horizontally on the screen. 
COPY Copies a field from one location to another on the screen. 
DEFINE Defines attributes for fields on a screen you are creating. 
DRAW Draws a line or box. 
ERASE Erases a field. 
EVENTS Defines function keys for a screen you are creating. 
MARK Marks a field for using an editing function. 
MOVE Moves a field from one location to another on the screen. 
NOKEYS Turns off the display of function key prompts. 
QUIT Ends an SDF session. 
RULER Displays character and line positions on the screen. 
SAVE Saves a screen. 
SCL Enables the user to enter an SCL command. 
SEEDEF Displays the screen profile and the defined dynamic 
attributes. 
SHOW Displays the screen you are creating or editing. 
TOGGLE Displays either the MAIN or SECONDARY editing functions. 
UNDO Cancels an editing change. 
UNMARK Unmarks a marked field. 
NOTE 


The exact placement of function key assignments is dependent on the 
terminal model you are using. All examples in this manual are of the 
CDC/721 terminal. 


Many of the editing functions require that your first mark the area to be 
edited using the MARK function. After marking the area, press the 
appropriate function key for the function you want to perform. For 
example: 

“ To MOVE, COPY, CENTER, and ERASE a field, first MARK the field and 
then press the indicated function key for the function you want to 
perform. 
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= To change a field, MARK the area, then press the ERASE function key 
to delete the field. You can then type new information in the same 
area and redefine the field. 


To define attributes for a field, MARK the field first, then use the 
DEFINE function key. You are prompted to indicate the type of data 
you want to define (constant text, numeric or character variable, or 
table). After indicating your choice, the appropriate Define 
Attributes screen is displayed. The desired attributes for the field 
are entered on this screen. 


You can now begin creating your screen. Creating a screen is like 
painting a picture; except in this case, the paint brush is your 
keyboard. You simply design the screen as you want it to appear. Each 
item that you enter on the screen is called a field. 


SDF allows you flexibility in how you design the screen. You can: type 
constant text, such as titles, column headings and instructions in the 
desired areas; use the DEFINE function to define fields; use editing 
functions to perform a variety of functions on the screen you are 
creating; and draw graphics (lines and boxes) on the screen. 


For any type of field entered on a screen, you can define various 
highlighting styles (such as inverse video, blinking, and underlining). 
For variables and tables you can define additional attributes (such as, 
type of data, how data can be input or output and maximum characters). 


A screen created by SDF can contain fields made up of: 
CONSTANT TEXT 


Character strings, such as titles, instructions, menus and column 
headings. You simply type the fields at the location you want 
them to appear. You can change such text by typing over it. 
Constant text does not have to be defined unless display 
attributes are desired. After defining constant text, it becomes 
protected and cannot be changed. 


VARIABLES 


Numeric and character variables that can be changed by the user 
or a program. Variable fields can be single fields or part of a 
table. The location of a variable field must be marked and then 
defined to specify its size, type, I/O mode, and highlighting. 


TABLES 


Areas on the screen containing one or more occurrences of 
variables. Tables are generally made up of variable fields 
organized in rows and columns. The first occurrence of each 
variable that is part of a table must be defined as variables. 
To define a table, you must MARK an area enclosing the first 
occurrences of each variable, or the entire area the table will 
occupy and use the DEFINE function. See Creating a Table later 
in this section for details. 
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LINES and BOXES 


Graphics that can be used, for example, to identify areas on the 
screen where data can be input, to frame a screen or indicate the 
boundaries of a table. You can only define highlighting 
attributes to a line or box. 


Example of Designing a Screen 


The following pages illustrate how to design the sample screen shown 


below. You can signon to SDF and use this example to acquaint yourself 
with how to use SDF. 


The screen has constant text fields, numeric and character variables, a 
table with ten occurrences of variables, and a highlighted line drawn on 
it. When the screen is displayed by the application program, the end 
user enters a Department Number. The Name, Title and Salary for each 


employee in the specified department are displayed by the application 
program. 


Enter the Department Number: 


NAME 


Entering Constant Text 


Constant text fields are simply typed at the location you want them to 
appear on the screen, or you can place these fields anywhere on the 
screen and move them around at any time using editing functions. 
Constant text fields do not have to be defined unless highlighting is 
desired. Before constant text is defined, it can be changed by simply 
typing over it. After defining constant text, it becomes protected and 
cannot be changed. The constant text fields on the sample screen are: 


Enter the Department Number: 
NAME, TITLE and SALARY 
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For this example, inverse video will be defined for the field, Enter @ 
Department Number:. The following illustrates how these fields are 


entered on the screen: 


1. Type the following on the screen: 


Enter the Department Number: 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark {F2|Define [F3| Draw |F4] Move |F5 F6} Quit |F7|Toggle jF8|Center 


2. To define inverse video for this field, position the cursor on the 
first character of the field and press the MARK function key. The 


character is highlighted. 
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3. Then position the cursor on the last character of the field and press 
the MARK function key again. The entire field is highlighted. 


Unmark Erase Scl Copy NoKeys Ruler 
FliMark {[F2/Define|F3] Draw [F4}] Move |F5 F6} Quit |F7/Toggle |F8/Center 


4. Press the DEFINE function key. The Choose Data Type overlay is 
displayed: 


Choose a data type for DEFINE 
Press CONST to define a text constant 
Press CHRVAR to define a character variable 


Press NUMVAR to define a numeric variable 
Press TABLE to define a table 


Press NEXT or BACK to return to edit 
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5. Press the CONST function key to indicate you are defining a constant 


text field. The Define Attributes screen for a constant text field 
is displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY @ 
SELECT 


EDIT DEFINE ATTRIBUTES 
—>DEF INE Text Constant 


Attribute Value(s) 

Name: 

Logical highlights: normal italic title input error message 

Physical highlights: normal inverse high low _ blink _underline 
Background color: _black blue green magenta red cyan yellow white 


Foreground color: _black blue green magenta red cyan _yellow white 


Type any character next to list choices 
Use SYSTEM or REPEAT for defaults 
Press FINISH when completed, or CANCEL to cancel 


6. Enter a name for the field and any character in the blank space next  ] 
to inverse which is the attribute you want for this field. For 
example: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

->DEF INE Text Constant 


Attribute Value(s) 
Name: 
Logical highlights: normal italic title input error message 


Physical highlights: “normal Xinverse high _low _blink _underline 
Background color: black blue green magenta red cyan yellow white 


Foreground color: _black _blue green magenta red cyan “yellow white 


Use SYSTEM or REPEAT for defaults 
Press FINISH when completed, or CANCEL to cancel 


Type any character next to list choices & 
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7. Press the FINISH function key. The screen is displayed with the 
field highlighted in inverse video. 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark j|F2|Define |F3| Draw |F4] Move |F5 F6] Quit |F7}|Toggle |F8/Center 


| 8. Move the cursor down five lines. Type the constant text fields NAME, 
& TITLE and SALARY on the screen: 


Enter the Department Number: 


NAME 


Unmark Erase Sel Copy NoKeys Ruler 
Fl[Mark |F2|Define |F3| Draw |F4] Move |F5 F6] Quit | F7] Toggle [F8/Center 


| These fields will serve as column headings for a table that will be 

& created later in this example. Since highlighting will not be defined 
for these constant text fields, this ends the example of entering 
constant text fields on a screen. 
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Entering Variables 


Numeric and character variables can be single fields or part of a table. 
A variable must be defined to specify its attributes, such as, the type 
of data, the input/output mode (whether data can be entered by the user, 
the program or both), and the maximum number of characters. Optionally, 
you can also define highlighting and color for a variable. 


There are two numeric variables (Department Number and SALARY) and two 
character variables (NAME and TITLE) on the sample screen. 


The following illustrates how the numeric variable Department Number is 
entered and defined: 


1. Position the cursor on the first blank space after the word Number:. 
Press the MARK function key. The space is highlighted. 


2. Position the cursor four spaces to the right of the first highlighted 
Space. Press the MARK function key again. The entire area is 
highlighted. 


Enter the Department Number: 


NAME 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark |F2|Define |F3| Draw |F4] Move [FS F6] Quit |F7}|Toggle |F8[Center 
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3. Press the DEFINE function key. The Choose Data Type overlay is 
displayed: 


Choose a data type for DEFINE 
Press CONST to define a text constant 
®& Press CHRVAR to define a character variable 


Press NUMVAR to define a numeric variable 
Press TABLE to define a table 


Press NEXT or BACK to return to edit 


4. Press the NUMVAR function key to indicate you are defining a numeric 
variable. The Define Attributes screen for a numeric variable is 
displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 


->DEF INE Numeric Variable 


@ Attribute Value(s) 
Name: 
Variable type: _integer _ real 


Logical highlights: normal italic title input error message 
Physical highlights: normal inverse high low blink underline 


Background color: _black blue green magenta red cyan yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
I/O mode: _input input/output _output 


Fill appropriate blanks 
Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
Press TABLE, if shown, to see table definition 
Press FORMAT, if shown, to specify output format 
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5. Enter a name for the variable and type any character in the blank 
Spaces next to the attributes you want for this field. For this 
example the variable is an integer and data can only be input by the 
application user. 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

->DEFINE Numeric Variable 


Attribute e(s) 
Name: eS 
Variable type: Ainteger real 


Logical highlights: “normal italic title input error _message 
Physical highlights: _normal inverse high low blink underline 


Background color: _black blue green magenta red cyan yellow white 
Foreground color: black blue green magenta red cyan yellow white 
1/0 mode: Sinput input/output _output 


Fill appropriate blanks 
Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
Press TABLE, if shown, to see table definition 
Press FORMAT, if shown, to specify output format 


After completing the screen, do one of the following: 


1. If the screen will be used by a COBOL or CYBIL application progran, 
press the FINISH key. The screen is displayed with an underline 
highlighting the area that was marked and defined for the variable. 


Enter the Department Number: 


NAME 


Unmark Erase Scl Copy NoKeys Ruler 
FliMark [F2jDefine |F3] Draw |F4] Move [F5 F6] Quit | F7|Toggle [F8{Center 
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2. If the screen will be used by a FORTRAN application program, the 
output format must be specified for numeric variables associated with 


the screen. You can either enter the output format or apply the 
defaults supplied by Screen Formatting. 


To apply the default output format definitions, press the FINISH 


key. The defaults are applied and the screen is displayed again with 
© an underline highlighting the area that was marked and defined for 
the variable. 


To enter the output format for the variable, press the FORMAT key. 
The Define FORTRAN Format screen shown below is displayed: 


EDIT NOS/VE SCREEN DESIGN FACILITY 

SELECT 

DEF INE DEFINE FORTRAN FORMAT 

—>FORMAT Numeric Variable 

Name: Maximum width Integer 

Attribute Value(s) 

Output format type: E F Git 

E,F,G format: e Total width Digits right of decimal 
Always signed: _Yes No 
Suppress zero: _Yes No 
Number of digits: in the exponent 

I format: Total width Minimum output digits 
Always signed: _Yes No 

r Choose output format type and fill appropriate blanks 


Type any character next to list choices 
Press FINISH when completed, or CANCEL to cancel 


a 


The screen is used to specify the output format for either a real 
variable in the E, F, or G format, or an integer variable in the I 
format. The items shown on the screen are described in this section 
under Defining the FORTRAN Output Format. 


After completing the screen, press the FINISH key. The screen is 
desplayed again. 


This ends the example of entering and defining a numeric variable. In 


the next example, you will see how variables that are part of a table are 
entered. 
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Creating a Table 


A table, which can only contain variables, can have one occurrence of two 
or more variables, two or more occurrences of one variable, or many 
occurrences of many variables. Any variable type (character or integer) 
can be a member of a table. 


A table can have variables that are grouped horizontally or vertically. 
Placement on the screen is controlled by how you define the individual 
variables that make up the table. 


The occurrences for each variable in the table can only be arranged 
vertically on the screen. For example: 


VARIABLE 1 VARIABLE 2 VARIABLE 3 (Occurrence) 
Occurrence Occurrence or VARIABLE 4 (Occurrence) 
Occurrence Occurrence VARIABLE 3 (Occurrence) 


VARIABLE 4 (Occurrence) 
VARIABLE 3 (Occurrence) 
VARIABLE 4 (Occurrence) 


For this example, the variables that make up the table are the NAME, 
TITLE and SALARY of employees in a specific department. The text 
constant fields that were entered on the screen are the column headings 
for the table. You will define the NAME field as a character variable in 
this example. 
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To create the table: 


1. You will first define as a character variable, the first occurrence 
of the field NAME (21 character field). To define the field, 
position the cursor two lines below the column heading, under the N. 
Press the MARK function key. The blank space is highlighted. 


@ 2. Move the cursor 20 spaces to the right of the first highlighted blank 
space. Press the MARK function key again. The entire area is 


highlighted. This area represents the first occurrence of the 
variable NAME. 


Enter the Department Number: 


NAME 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark j|F2|Define ]F3| Draw |F4] Move [FS F6] Quit | F7| Toggle /F8|Center 


3. Press the DEFINE function key. The Choose Data Type overlay is 
displayed: 


Choose a data type for DEFINE 
Press CONST to define a text constant 
Press CHRVAR to define a character variable 
Press NUMVAR to define a numeric variable 
Press TABLE to define a table 


Press NEXT or BACK to return to edit 


4, Press the CHRVAR function key to indicate you are defining a 
character variable. The Define Attributes screen for a character 
variable is displayed: 
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5. Enter a name for the variable and type any character in the blank 
space next to the attributes you want for this field. For this 
example the following attributes are selected: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 


->DEF INE Character Variable 


Attribute Value(s) 
Name: : 
Variable type: Acharacter textbox 

Logical highlights: normal italic title input error message 
Physical highlights: normal inverse high low blink underline 


Background color: _black blue green magenta red cyan yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
1/0 mode: _input _input/output Xoutput 


Upper case mode: 
Maximum characters: : (character or textbox) 
End of line wrap: ~word _character (textbox only) 

Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 

Press TABLE, if shown, to see table definition 


nf ive nin fae [Joo 


6. Press the FINISH function key. The screen is displayed with an 
underline highlighting the first occurrence of the variable NAME. 


Enter the Department Number: 


NAME 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark {F2{Define |F3] Draw |F4] Move [F5 F6] Quit | F7}| Toggle jF8/Center 
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Repeat this procedure for the first occurrences of the remaining two 
variables, TITLE (a 10 position character variable) and SALARY (an 8 


position numeric variable). When you finish the screen will look 
like the following: 


Enter the Department Number: 


NAME 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark [F2|Define|F3| Draw |F4] Move |F5 F6] Quit [F7|Toggle jF8|Center 
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7. Next you must mark the area the table will occupy. There are two 
methods available. You can MARK either: 


a. An area enclosing only the first occurrences of each of the 
variables to be included in the table. Position the cursor on 
the first character of the first variable to be included in the 
table and press the MARK function key. The character is 


highlighted. Next, position the cursor on the last character of 
the last variable to be included in the table and press the MARK 


function key again. All variables included in the marked area 
are highlighted. For example: 


Enter the Department Number: 


NAME 


Unmark Erase Copy NoKeys Ruler 
Fl[Mark {F2|Define |F3 F4| Move |F5 F6] Quit |F7|Toggle j|F8/Center 


With this method, when you access the Define Attributes screen 
for a table you must specify the number of visible occurrences 


for the table, and the maximum number of occurrences that can be 


transferred to the table. 
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b. The entire area you want the table to occupy. This area must 
include the first occurrence of each variable to be included in 
the table, and must extend vertically under the first occurrences 
for as many visible occurrences as you want for the table. 
Position the cursor on the first occurrence of the first variable 
to be included in the table and press the MARK function key. The 
entire variable is highlighted. Next, position the cursor on the 
Opposing corner (non-adjacent) from the first highlighted 
variable and press the MARK function key. The entire boxed area 
the table will occupy is highlighted. For example: 


Enter the Department Number: 


NAME 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark |F2{Define |F3| Draw |F4| Move |F5 F6] Quit | F7] Toggle |F8/Center 


With this method, the system determines the number of visible 
occurrences and the maximum number of occurrences the marked area 
can contain. When you access the Define Attributes screen for a 


table, you simply press the SYSTEM function key and these values 
are automatically displayed. 


8. Press the DEFINE function key. The Choose Data Type screen is 
displayed: 


Choose a data type for DEFINE 
Press CONST to define a text constant 
Press CHRVAR to define a character variable 


Press NUMVAR to define a numeric variable 
© Press TABLE to define a table 


Press NEXT or BACK to return to edit 
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9. Press the TABLE function key to indicate you are defining a table. 
The Define Attributes screen for a table is displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

~—>DEF INE Table 


Attribute Value(s) 
Name: 


Visible occurrences: 
Maximum occurrences: 


Fill appropriate blanks 
Use SYSTEM or REPEAT for defaults 


Press DELETE to remove table definition 
Press FINISH when completed, or CANCEL to cancel 


10. Enter a name for the table. Depending on how you marked the 
variables, you can either enter the values for visible and maximum 
occurrences, or press the SYSTEM function key for the system to 
calculate these values. An example of a completed screen is shown 
below: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
EDIT DEFINE ATTRIBUTES 
—>DEFINE Table 


Attribute Value(s) 


Name: 
Visible occurrences: 
Maximum occurrences: 


Fill appropriate blanks 
Use SYSTEM or REPEAT for defaults 

Press DELETE to remove table definition 

Press FINISH when completed, or CANCEL to cancel 
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11. Press the FINISH function key. The screen is displayed with an 
underline shown for each variable occurrence defined for the table. 


Enter the Department Number: 


NAME 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark [F2]Define |F3] Draw |F4] Move |F5 F6] Quit |F7|Toggle |F8 {Center 
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Drawing Boxes and Lines 


Boxes and lines can be drawn anywhere on a screen. They can be drawn to 


indicate areas on the screen where data is to be input or output, to 
frame a screen, indicate the boundaries of a table, or to decorate a 
screen. You can only define highlighting attributes for a box or line. 


The following illustrates how the line dividing the end users input area 
and the table area is drawn: 


1. Position the cursor on a blank space between the areas you want to 
Separate. Press the MARK function key. The space is highlighted. 


2. Position the cursor as many spaces as desired to the right of the 
first highlighted space. Press the DRAW function key. The line is 
drawn. 


Enter the Department Number: 


NAME 


Unmark Erase Sel Copy NoKeys Ruler 
FliMark {F2|Define |F3| Draw |[F4] Move [F5 F6} Quit |F7}|Toggle jF8/Center 
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3. Position the cursor anywhere on the line. Press the MARK function 
key. The entire line is highlighted. 


Enter the Department Number: 


Unmark Erase Scl Copy NoKeys Ruler 
Fl{Mark [F2[Define |F3{ Draw {F4] Move [F5 F6} Quit |F7} Toggle /F8]Center 


4. Press the DEFINE function key. The Define Attributes screen for a 
& box or line is displayed. 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

—>DEF INE Box or Line 


Attribute Value(s) 

Name: 

Intensity: _normal high low 

Color: _black blue green magenta red cyan yellow white 
Line width: _fine medium bold 


Fill appropriate blanks 
Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
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3. Enter any character in the blank space next to the attributes you 
want for the line. For this example the following attributes are 


selected: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
EDIT DEFINE ATTRIBUTES 


—>DEF INE Box or Line 


Attribute Value(s) 
Name: 
Intensity: 


Knormal high _low 


Color: ~ black blue green magenta red cyan yellow white 


Line width: "fine Kmedium _bold 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
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6. Press the FINISH function key. The screen is displayed with a medium 
e width line showing as specified in the definition. 


Enter the Department Number: 


NAME 


Unmark Erase Scl Copy NoKeys Ruler 
FljMark |F2{Define |F3| Draw |F4] Move [F5 F6] Quit | F7/Toggle |F8/Center 


This concludes the example of creating a screen. The sequence that was 

© used to create the screen in the example is not the sequence that you 
have to use when you create screens. SDF allows you to create your 
screen in any sequence desired. 
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Editing a Screen 
(SELECT Function) 


The SELECT function displays an existing screen for editing. 


The screens that currently reside in your library are listed on the 
Select screen. If you have more screens than those listed, use the 
scrolling and paging keys (FWD, BKW, UP and DOWN) to examine all of the 
screens in your library. 


Once you find the desired screen, position the cursor next to the screen 
name and press the SELECT function key. 


The selected screen is displayed with the editing functions represented 
as function key prompts at the bottom of the screen. The editing 
functions are described in detail later in this section on the manual. 


When you select a screen for editing, it is always displayed at line l, 
column 1 with a horizontal and a vertical line indicating the defined 
width and height of the screen, even if the selected screen is smaller 
than the terminal display, or defined to be displayed at a location other 
than line 1 column 1. When you edit the screen, you cannot enter fields 
outside of the horizontal and vertical lines; the areas outside of these 
lines are protected. 


The selected screen is called the User Edit screen. An example of the 
screen is shown below: 


EMPLOYEE INFORMATION 


Name: Birthdate: / f 
Home address: 

City, State: 

Zip Code: 


Hire date: 
Job title: Grade: 

Dept. number: Facility: 
Division name: 


Salary: Exemptions: 


Unmark Erase Sel Copy NoKeys Ruler 
FiiMark {F2|Define|F3] Draw |F4] Move [F5 F6] Quit |F7/Toggle |F8}|Center 
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If you do not want to edit the selected screen, you can either: 


e Press the BACK key; the Select screen is displayed again and you can 
select another screen or another function. 


@ Press the QUIT function key to end the SDF session; you are returned 
to NOS/VE. 


If you want to copy a screen, simply select the desired screen, then save 
it using a different name. 


Creating and editing screens is the major activity of an SDF session. 
When you select a screen for editing, or you choose to create a new 


screen, the editing functions are represented as function key prompts at 
the bottom of the screen: 


Unmark Erase Scl Copy NoKeys Ruler 
Fl|Mark |F2|Define|F3| Draw |F4] Move [F5 F6] Quit |F7]| Toggle jF8/Center 


The functions shown above are the MAIN editing functions. The functions 
listed on the top line are initiated by pressing the SHIFT key and the 
function key indicated. 


The TOGGLE function displays SECONDARY editing functions. 


Scl 


Pressing the TOGGLE function key toggles between the Main and Secondary 
editing functions. To use an editing function, the function key prompt 
must be displayed at the bottom of the screen. 
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The editing functions are briefly described below. Detailed descriptions 


are provided later in this section. 


ATTRIB Defines dynamic attributes for the entire screen. 
CENTER Centers a field horizontally on the screen. 
COPY Copies a field from one location to another on the screen. 
DEFINE Defines attributes for fields on a screen. 
DRAW Draws a line or box. 
ERASE Erases a field. 
EVENTS Defines function keys for a screen you are creating. 
MARK Marks a field for using an editing function 
MOVE Moves a field from one location to another. 
NOKEYS Turns off the display of function key prompts. 
QUIT Ends an SDF session. 
RULER Displays character and line positions for items on a screen. 
SAVE Saves a screen. 
SEEDEF Displays the screen profile and the defined dynamic 
attributes. 
SCL Enables user to enter an SCL command. 
SHOW Displays the screen you are creating or editing. 
TOGGLE Toggles betwen the Main and Secondary editing functions. 
UNDO Cancels an editing change. 
UNMARK Unmarks a marked field on a screen. 
NOTE 


The exact placement of function key prompts is dependent on the terminal 
model you are using. All examples in this manual are of the CDC 721 
terminal. 


Many of the editing functions require that you first use the MARK 
function to mark the area to be edited. After marking the area, press 
the appropriate function key for the function you want to perform. For 
example: 


e A field is moved, copied, centered, erased and defined by marking the 
area with the MARK function key, and then pressing the appropriate 
function key for the function you want to perform. 
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e To change or delete a field, MARK the area, then press the ERASE 
function key. You can then type new information in the same area and 
redefine the field. 


6 To define attributes for a field, MARK the field, then press the 
DEFINE function key. You are prompted to indicate the type of data 
you want to define (constant text, variable, or table). After 
responding, a Define Attributes screen for the specified data type is 
presented. You specify the attributes for the field on this screen. 


After you finish editing the screen, you can use the secondary editing 


function SAVE to save the screen in your library. 


Example of Editing a Screen 


Using the sample screen shown below, this example will illustrate how to: 


1. DELETE the field Division Name. 


2 MOVE the field Exemptions up one line on the screen. 


EMPLOYEE INFORMATION 


Name: Birthdate: 
Home address: 
City, State: 


Zip Code: 


Hire date: 
Job title: Grade: 

Dept. number: Facility: 
Division name: 


Salary: Exemptions: 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark {F2[Define [F3[ Draw |F4] Move |[F5 F6) Quit |F7 | Toggle [F8|Center 


To delete the field Division Name: 


1. Position the cursor on the first character of the field to be deleted 


(in this case the D). Press the MARK function key. The D is 
highlighted. 
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2. Position the cursor on the last character of the field (in this case 
at the end of the solid line). Press the MARK function key. The 
entire field is highlighted. 


EMPLOYEE INFORMATION 


Name: Birthdate: 
Home address: 

City, State: 

Zip Code: 


Hire date: 
Job title: Grade: 
Dept. number: Facility: 


Exemptions: 


Unmark Erase Sel Copy NoKeys Ruler 
FliMark {F2|Define |F3}| Draw |F4] Move |F5 F6{ Quit [F7|Toggle /F8|Center 


3. Press the ERASE function key. The field and all of it’s attributes 
are deleted as shown below. 


EMPLOYEE INFORMATION 


Name: Birthdate: 
Home address: 

City, State: 

Zip Code: 


Hire date: 
Job title: Grade: 
Dept. number: Facility: 


Salary: Exemptions: 


 [Unmark Erase Sel Copy NoKeys Ruler 
FljMark {[F2[Define |F3]| Draw |F4] Move |F5 F6} Quit | F7 | Toggle [F8 [Center 
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© To move the field Exemptions up one line: 


1. Position the cursor on the first character of the field to be moved 
(in this case the E). Press the MARK function key. The E is 


highlighted. 
2. Position the cursor on the last character of the field (in this case 
@ at the end of the solid line). Press the MARK function key. The 


entire field is highlighted. 


EMPLOYEE INFORMATION 


Name: Birthdate: 
Home address: 

City, State: 

Zip Code: 


Hire date: 
Job title: Grade: 
Dept. number: Facility: 


Salary: 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark |F2[Define |F3| Draw |F4] Move |F5 F6} Quit | F7{Toggle /F8|Center 
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3. Position the cursor at the beginning of the area where you want the 
field to be moved. Press the MOVE function key. The field is moved 
to the area where the cursor is positioned. 


EMPLOYEE INFORMATION 


Birthdate: 


Name: 
Home address: 
City, State: 
Zip Code: 


Hire date: 
Job title: Grade: 
Dept. number: Facility: 


Salary: Exemptions: 


Unmark Erase Scl Copy NoKeys Ruler 
Fl jMark {F2{Define|F3{ Draw |F4] Move {F5 F6} Quit |F7{[Toggle |F8[Center 


Copving a Screen 
(SELECT Function) 


To copy a screen: 


1. Position the cursor next to the screen name on the Select screen and 
press the SELECT function key. 


2. When the screen is displayed, press the SAVE function key. The 
following overlay is displayed: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran cde fortran _cybil 


3. On the line, enter a different name for the screen. The screen will 
be copied and saved in your library under the new name. 
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4, The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition 
generated for the screen. The language already checked is the 
language specified for the existing screen. You can specify as many 
of the languages listed by entering any character next to your 
choices. There will be one SCU deck generated for each language 


selected. If no languages are selected, no record definitions will 
be generated. 


Displaying a Screen 
(SHOW Function) 


The SHOW function on the Select screen displays an existing screen. 


To display a screen, position the cursor next to the desired screen on 
the screen list and press the SHOW function key. The selected screen is 
displayed. 


The screen is displayed as it will appear to the end user, with all of 
the defined highlighting and attributes in effect. 


To clear the screen from the display and return to the SELECT screen: 


Press the NEXT key (RETURN or NEW LINE on some terminals) or the BACK 
key. No other function keys are operational. 


Cancelling a Previous Delete Function 
(UNDO Function) 


The UNDO function on the SELECT screen cancels the last DELETE function 
you initiated (the DELETE function deletes a screen). Only the last 
DELETE function is cancelled. 


When you delete a screen, the screen name is removed from the list of 
screens displayed on the Select screen. 


If you decide that you do not want the screen deleted, press the UNDO 
function key; the screen name reappears in the list of screens. 


The UNDO function must be initiated before the next SELECT or CREATE 
function is initiated. 


Deleting a Screen 
(DELETE Function) 


The DELETE function on the Select screen deletes a screen from the list 
of screens on the Select screen. 


To delete a screen, position the cursor next to the name of the screen 
and press the DELETE function key. The screen name is removed from the 
list of screens. 


If you decide that you do not want the screen deleted, press the UNDO 
function key to cancel the DELETE function. 
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Ending an SDF Session 
(QUIT Function) 


The QUIT function ends an SDF session and returns you to NOS/VE. 


If you press the QUIT function key from the Banner screen, or from the 
Select screen, you are immediately returned to NOS/VE. 


If you press QUIT after using an editing function on a new or existing 
screen and you have not used the SAVE function, SDF offers you a chance 
to save the screen by overlaying the screen with the following message: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran cde fortran _cybil 


Press the NEXT key to replace an existing screen to which you have made 
changes. Enter a unique name and press NEXT to save a new screen, press 
the BACK key to discard the screen, or press QUIT to exit SDF (the screen 
will also be discarded). 


The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition generated 
for the screen. The language checked is the language specified when you 
defined the screen profile. You can enter any character next to as many 
of the languages as desired. There will be one SCU deck generated for 
each language selected. If no languages are selected, no record 
definitions will be generated. 


If you press QUIT and you have not used an editing function, the message 
is not displayed; the session is ended and the entries are discarded. 


Changing the Screen Profile 
(PROFIL Function) 


The PROFIL function is used to display and change the characteristics 
defined for a screen. You can change any of the items that are on the 
screen: the programming language the application is written in, color 
attributes, thickness of the screen border, screen width and height and 
the position the screen will occupy on the end users terminal. 


To access the Define Screen Profile screen: 


1. Access the Select screen. Position the cursor next to the name of the 
screen for which you want to change the profile. 


2. Press the PROFIL function key. 
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The Define Screen Profile screen shown below is displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT DEFINE SCREEN PROFILE 
->PROFIL 


Attribute Value(s) 


Programming Language: _cobol ansi fortran CDC fortran cybil 

Background color: _black blue green magenta red cyan _ yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
Screen border: _fine medium bold _none 

Screen width: 

Screen height: 

x-origin: 

y-origin: 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 


To change items on the Define Screen Profile screen, use the space bar to 
blank out the existing selection and enter any character next to your 

@ choice, or type over the existing values. If you do not want to enter 
values, you can: 


Use the SYSTEM function to apply the default screen characteristics 
to items on the screen. 


Use the REPEAT function to apply the same characteristics that you 
specified for the previous screen you defined. 


Use the FINISH function when you have completed your entries. 


Use the CANCEL function to cancel the definitions for the screen. 
You are returned to the Select screen. 


The items on the Define Screen Profile screen are described next. 


Specify the programming language used for the application that 
accesses this screen. The default is Cobol. When you save the 
screen, SDF creates a source program record description in that 

r language, and writes it to the file specified by the SOURCE parameter 


on the DESS command when you accessed SDF. The record description 
describes the data fields on the screen. The record description can 


be inserted in the application program for compilation as part of the 
program. 
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Specify the color of the screen behind the lines and characters on 


the screen. Selected areas of the screen can have a different 
background color, if specific color attributes are specified for 


certain screen areas. 


Specify the color of the lines and characters displayed on the 
screen. Selected areas of the screen can have a different foreground 
color, if specific color attributes are specified for certain screen 
areas. 


Specify the thickness of the lines that make up the border of the 
screen if a border is desired. The size of the border is determined 
by the values entered for screen height, width, x-origin and y-origin 
on this screen. When you define a border, you cannot design the the 
screen outside of that perimeter. Note that the border does not 
appear unless the SHOW function is used to look at the screen. 


(OPTIONAL) 


Enter the width of the screen, in columns. The maximum width is the 
width of the terminal you are using and is the default. The minimum 
width is 1 column. 


(OPTIONAL) 


Enter the height of the screen, in lines. The maximum height is the 


height of the screen you are using and is the default. The minimum 
height is 1 line. 


(OPTIONAL) 


Enter the column on the end users terminal display that will be the 
left edge of the screen when displayed. The default is column l. 


(OPTLONAL) 


The line number, on the end users terminal display, that will be the 
top line of the screen when displayed. The default is line l. 


If you want the size of the screen to adjust automatically to the size of 
any terminal on which the application is processed, leave screen height, 
width, x-origin and y-origin blank. The screen size will be variable and 
will adjust automatically according to terminal type. 


When values are entered for screen height, width, x-origin and y-origin, 
the screen size is set to the size specified. When the defaults are used 
for these definitions, the screen size is set to the size of the terminal 
you are using. In either case, the screen size will not adjust 
automatically to different terminal types. 


When you complete all of the entries on the Define Screen Profile screen, 


press the FINISH key. The Select screen is displayed again. You can 
select another function. 
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Main Editing Functions 


Centering a Field 
(CENTER Function) 


The CENTER function moves a field and relocates it, horizontally, to the 
center of the width of the screen. 


The initial position of the area to be centered can be anywhere on the 
screen, to the left or right of the center. 


The marked area can include any type of field, including free text. 
To center a field: 


1. MARK the field to be centered. Refer to the MARK function described 
in this section of the manual. 


2. Press the CENTER function key. The marked field is moved to the 
center of the screen. 


“n e re , 
Copying a rieia 


(COPY Function) 


The COPY function copies a field to another location on the screen. 


If you attempt to copy a field into an occupied area, SDF issues an error 
message and allows you to retry at a different location, or you can use 
the ERASE function to erase the conflicting fields at the copy 
destination, and then use COPY again. 


If the area to be copied contains variables, they must be redefined at 
the new location. Also, the variable names must be changed to avoid 
duplicate name conflicts. Any such conflicts cause an error message when 
you try to SAVE the screen. 


To copy a field: 


1. MARK the field to be copied. Refer to the MARK function described in 
this section of the manual. 


2. Position the cursor at the upper left corner of where you want the 
marked field to appear. 


3. Press the COPY function key. The marked field is copied to the 
location where the cursor is positioned. 


Marked areas are remembered until UNMARKed or another MARK function is 


initiated. This enables multiple copies of the same area simply by 
repositioning the cursor for each COPY function. 
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Defining Attributes 
(DEFINE Function) 


The DEFINE function is used to define attributes for a field. You can 
also view and/or change attributes that are already defined. 


The attributes are associated with how the field is to appear on the 
screen, such as highlighting, or they describe qualities of the data 
associated with the field, such as data type, maximum characters or 
input/output mode. 


Defining a New Field 


l. 


2e 


MARK the area to be defined. The marked area must not split fields. 
Refer to the MARK function described later in this section. 


Press the DEFINE function key. SDF displays the following Choose 
Data Type overlay. 


Choose a data type for DEFINE 
Press CONST to define a text constant 
Press CHRVAR to define a character variable 


Press NUMVAR to define a numeric variable 
Press TABLE to define a table 


Press NEXT or BACK to return to edit 


Specify the type of field (constant text, character variable, numeric 
variable or table) you are defining by pressing the appropriate 
function key as indicated at the bottom of the overlay. 


A Define Attributes screen is presented. Depending on the type of 
field (constant text, character variable, numeric variable, table, or 
box and line) you are defining, a different Define Attributes screen 
is presented. 
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An example of the Define Attributes screen for a constant text field is 
shown below: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 


EDIT DEFINE ATTRIBUTES 
—>DEF INE Text Constant 


Attribute Value(s) 

Name: 

Logical highlights: normal italic title input error _message 

Physical highlights: normal _inverse high _low _blink _underline 
Background color: “black _blue _8reen magenta red cyan yellow white 


Foreground color: _black blue green magenta red cyan yellow white 


Type any character next to list choices 
Use SYSTEM or REPEAT for defaults 
Press FINISH when completed, or CANCEL to cancel 


The attribute lines are blank. To specify the desired attributes for the 
field, type any character in the blank space next to your choice. For 
example, the following shows inverse specified for the physical 
highlights of a field. 


Physical highlights: normal Xinverse high low _blink _underline 


To specify the system default attributes, press the SYSTEM function key. 
If the attributes for the current field are to be the same as those 
specified for the previous field, pressing the REPEAT function key 


automatically applies the attributes specified for the previous field to 
the current field. 


NOTE 


When defining a variable field, you must complete all of the required 


attributes on the Define Attributes screen. The system does not check for 
incompleted items; thus errors can occur. 


Viewing or Changing Attributes 


1. MARK and press the DEFINE function key for a field that is already 
defined; the appropriate Define Attributes screen is presented, 
showing the attributes that are already defined for the field. 
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2. To change existing attributes, move the cursor to the existing @ 
selection and press the space bar; the existing selection is deleted. 
You can then type any character in the blank space next to your new 
selection. 


To change the data type of the field, press the CANCEL function key 


or the BACK key to return to the User Edit screen. The field must be 
erased, reentered, and then redefined as a different data type, 


Functions on Define Screens 


The functions that are available on Define Attributes screens are 
described below. Some of these functions are also available on the 
Define Function Keys screen and the Define Screen Profile screen, both of 
which are available as secondary editing functions. The descriptions 
here apply to all of the Define screens. 


SYSTEM Function 


The SYSTEM function indicates that you want the system default 
attributes to be applied to the field. 


When the SYSTEM function key is pressed, the system default 
attributes appear in the attribute lines that have not been filled in. 


At any time before you press the FINISH key, you can change these 

attributes by typing new selections, or by using the REPEAT function 

to indicate that the attributes defined for the previous field are to 

be applied to the current field. ® 


REPEAT Function 


The REPEAT function enables you to apply attributes entered for the 
previous field to the field you are currently defining. This is only 
effective if both the previous and the current field are the same 
data type (constant text, character variable, numeric variable, 
table, or box and line). 


When all or part of the attributes for the current field are not 
filled in, pressing the REPEAT function key causes the attributes 
entered for the previous field to appear in the empty spaces. 


At any time before you press the FINISH key, you can change these 
attributes by typing new selections, or by using the SYSTEM function 
to indicate that system defaults are to be used. 


FINISH Function 


The FINISH function indicates that you have finished entering the 


attributes for the field. @ 


When you complete specifying the selected attributes for the field, 
and you are satisfied with your selections, press the FINISH function 
key. The attributes you have defined are saved for the field. 


3-46 Screen Design Facility Revision D 


Defining Attributes 


CANCEL Function 


The CANCEL function cancels a DEFINE function and returns you to the 
User Edit screen. Any attributes you have defined are also cancelled. 


To cancel, press the CANCEL function key. Using the BACK key, if 


your terminal has one, accomplishes the same function as CANCEL; 
@ however, BACK returns you to the previous screen listed in the 
context block. 


DELETE Function 


The DELETE function appears on the Define Attributes screen for a 
table, and on the Define Function Keys screen (displayed when you use 
the secondary editing function, EVENTS). 


On the Define Attributes screen for a table, DELETE is used to delete 
the table definition for a defined field. To delete the table 
definition, press the DELETE function key. 


On the Define Function Keys screen, DELETE is used to delete a 
function key definition. Position the cursor on the function key 
definition you want to delete, and press the DELETE function key. 


TABLE Function 


The TABLE function only appears on the Define Attributes screen for a 

character variable or numeric variable. It only appears when a 

variable field that has been defined as a table occurrence is MARKed, 
© and the DEFINE function key is pressed. 


The TABLE function enables you to view the table definition. 
To view a table definition, press the TABLE function key. 


FORMAT Function 


The FORMAT function only appears on the Define Attributes screen for 
a numeric variable. 


After completing the Define Attributes screen for a numeric variable, 
pressing the FORMAT function key displays the Define FORTRAN Format 
screen. The Define FORTRAN Format screen is used to specify the 
output format for the variable. The screen will have two sections, 
one for an integer variable and one for a real variable. 


The Define FORTRAN Format screen is shown later in this section. 
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Things to Know About Highlighting 


On most Define Attributes screens there are lines for specifying whether 
you want logical or physical highlighting: 


Logical highlights: _normal_italic_title_input_error_message 
Physical highlights: normal_inverse_high_low_blink_underline 


When you are defining attributes, only one of these lines should be 
filled in. It is important that you understand the difference between 
these two highlighting styles. 


Logical Versus Physical Highlights 


Logical highlights enable you to define physical highlighting styles 
without regard for the different types of terminals that will display the 
screen. Only one logical highlight may be specified. 


Each NOS/VE site can predefine, in the Terminal Definition Utility (TDU) 
up to six logical highlighting styles for each terminal type in use at 
the site. 


In the TDU these highlights have the logical names of normal, italic, 


title, input, error and message. The physical highlights actually 
displayed are controlled by how these names are defined in the TDU. 


For example, italic may be defined as inverse video in the TDU for one 
terminal type. For a terminal that cannot display inverse video, italic 
can be defined as underline. The effect is that, regardless of the 
terminal type, some form of highlighting can be applied. When defining 
logical highlights, you should be aware of the definitions in the TDU. 


When you specify logical highlights, screen definitions do not ever need 
to change to be usable on different terminals. The association of a 
logical highlight to an actual highlight can change simply by creating a 
new terminal definition in the TDU. 


Physical Versus Logical Highlights 


Physical highlights display highlights that correspond to the names, 
normal, inverse, high, low, blink and underline, and are only effective 
on a terminal that is capable of displaying the specific highlight. If a 
specific highlight is not possible for a given terminal, it may be 
replaced by another, or not highlighted when that terminal is used. 


More than one physical highlight may be specified, such as, inverse video 
and blink can be specified. 


If your application will be used on a single terminal type, physical 
highlights give you absolute control over highlighting styles, and thus, 
allow you to define, in detail, the visual effects for the screens 
displayed by your application. 


3-48 Screen Design Facility Revision D 


7 
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Defining Color for a Field 


On most Define Attributes screens there are lines for specifying that you 
want color applied to a field: 


Background Color: _black_blue_green_magenta_red_cyan_yellow_white 
@ Foreground Color: _black_ _blue_ 1 green _ magenta __ red __cyan_yellow_ white 


BACKGROUND COLOR is the color behind the displayed characters or graphics. 
FOREGROUND COLOR is the color of the characters and lines displayed. 

When you define color attributes, the selected color will only be 
displayed on terminals capable of displaying color. If the terminal 


which displays your screen is not color-capable, the color attribute is 
ineffective. 


Defining Attributes for Constant Text 


The Define Attributes screen for constant text is presented for defining, 
viewing or changing the attributes of a constant text field. 


Constant text fields are character strings of descriptive text used for 
such purposes as titles, column headings, instructions, or menus on 


screens you are creating. 


Constant text fields do not have to be defined unless you want to apply 
@& display characteristics such as highlighting and color. 


To access the screen to define a new field: 
1. MARK the area to be defined. 
2. Press the DEFINE function key. 


3. When the Choose Data Type overlay is displayed, press the CONST 
function key. 


To access the screen to view or change existing defintions: 
1. MARK a field that is already defined. 
2. Press the DEFINE function key. 
To exit the screen, you can either: 
@e Press the FINISH key to signal completion of defining attributes. 
You are returned to the User Edit screen. Any defined highlights are 


activated and displayed on the screen. 


© e Press the CANCEL key; the DEFINE function is cancelled and you are 
returned to the User Edit screen. 
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The Define Attributes screen for constant text is shown below: & 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
EDIT DEFINE ATTRIBUTES 


->DEF INE Text Constant 


Attribute Value(s) 
Name: 
Logical highlights: normal italic title input error message 


Physical highlights: normal _inverse high low blink _underline 
Background color: _black blue green magenta red cyan yellow white 


Foreground color: _black _ blue _green magenta red cyan yellow white 


Type any character next to list choices 
Use SYSTEM or REPEAT for defaults 
Press FINISH when completed, or CANCEL to cancel 


The attributes are described below: 


(OPTIONAL) @ 


Enter a name to be assigned to this constant text field. The name 
must comply with the naming conventions of the programming language 
used for the application. 


(OPTIONAL) 


If you use logical highlights, leave physical highlights blank. You 
may only specify one logical highlight. 


Logical highlights enable you to define physical highlighting styles 
without regard for the types of terminals that will display the 
screen. 


Each NOS/VE site can predefine, in the Terminal Definition Utility 
(TDU) up to six logical highlighting styles for each terminal type in 
use at the site. In the TDU these highlights have the logical names 
of normal, italic, title, input, error and message. The physical 
highlights actually displayed are controlled by how these names are 
defined in the TDU. 
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For example, italic may be defined as inverse video in the TDU for 
one terminal type. For a terminal that cannot display inverse video, 
italic may be defined as underline. The effect is that, regardless 
of terminal type, some form of highlighting can be applied. When 
defining logical highlights, you should be aware of the definitions 
in the TDU. 


When you specify logical highlights, screen definitions do not ever 
need to change to be usable on different terminals. The association 
of a logical highlight to an actual highlight can change simply by 
creating a new terminal definition in the TDU. 


(OPTIONAL) 


If you use physical highlights, leave logical highlights blank. You 
can specify more than one physical highlight. 


Physical highlights display highlights that correspond to the names, 
normal, inverse, high, low, blink and underline, and are only 
effective on a terminal that is capable of displaying the specific 
highlight. If a specific highlight is not possible for a given 
terminal, it may be replaced by another, or not highlighted when that 
terminal is used. 


If your application will be used on a single terminal type, physical 
highlights give you absolute control over highlighting styles, and 
thus, allow you to define, in detail, the visual effects for the 
screens displayed by your application. 


PTIONAL) 


Background color is the color behind the displayed characters or 
graphics. 


Foreground color is the color of the characters and lines displayed. 


When you define color attributes, the selected color is only 
displayed on terminals capable of displaying color. If the terminal 
which displays your screen is not color-capable, the color attribute 
is ineffective. 
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Defining Attributes for a Character Variable 


The Define Attributes screen for a character variable is presented for 
defining, viewing, or changing the attributes of a character variable. 


A variable is any character or numeric data whose value can be changed by 
the user, a program or both when the screen is displayed by the 
application program. Examples of using variables are: displaying the 
current date on a screen; display of report data by the application 
program; and data entry by the user. There are two types of character 
variables: 


Character String - A string of characters less than one line in 
length. 
Text Box - Multiple lines of the same length which contain 


wraparound character text. 


Attributes can be defined to specify the variable type, maximum 
characters, input/output mode, end of line wrap and highlighting. 


To access the screen to define a character variable: 
1. MARK the area to be defined. 
2. Press the DEFINE function key. 


3. When the Choose Data Type overlay is displayed, press the CHRVAR 


function key. e 


To access the screen to view or change existing defintions: 
1. MARK a field that is already defined. 

2. Press the DEFINE function key. 

To exit the screen, you can either: 


e Press the FINISH key to signal completion of defining attributes. 
You are returned to the User Edit screen. 


Any defined highlights are activated and displayed on the screen. If 
no highlights were defined, defined variables are temporarily 
highlighted by SDF. 


e Press the CANCEL key; the DEFINE function is cancelled and you are 
returned to the User Edit screen. 
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The Define Attributes screen for a variable is shown below: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

~>DEF INE Character Variable 


Attribute Value(s) 
Name: 
Variable type: _character _textbox 


Logical highlights: “normal italic title input error _mMessage 
Physical highlights: normal inverse high low blink underline 


Background color: black _blue _green magenta red _cyan _yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
1/0 mode: _input input/output output 

Upper case mode: _Yes _No 

Maximum characters: (character or textbox) 

End of line wrap: _word _character (textbox only) 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
Press TABLE, if shown, to see table definition 


The attributes are described below. 


(REQUIRED) 


Enter a name to be assigned to this variable. The name must be 
unique to this screen and comply with the naming conventions of the 
application programming language. The variable name is referenced by 
the application program to manipulate the data associated with the 
variable. 


(REQUIRED) 
Specify the type of character variable. The types are: 
Character String - The default. A string of characters less 
than one line in length. 
Text Box - Multiple lines of the same length which 


contain wraparound character text. 
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(OPTIONAL) @ 


If you use logical highlights, leave physical highlights blank. You 
may only specify one logical highlight. 


Logical highlights enable you to define physical highlighting styles 


without regard for the types of terminals that will display the @ 
screen. 


Each NOS/VE site can predefine, in the Terminal Definition Utility 
(TDU) up to six logical highlighting styles for each terminal type in 
use at the site. In the TDU these highlights have the logical names 
of normal, italic, title, input, error and message. The physical 
highlights actually displayed are controlled by how these names are 
defined in the TDU. 


For example, italic may be defined as inverse video in the TDU for 
one terminal type. For a terminal that cannot display inverse video, 
italic may be defined as underline. The effect is that, regardless 
of terminal type, some form of highlighting can be applied. When 
defining logical highlights, you should be aware of the definitions 
in the TDU. 


When you specify logical highlights, screen definitions do not ever 


need to change to be usable on different terminals. The association 
of a logical highlight to an actual highlight can change simply by 


creating a new terminal definition in the TDU. 


(OPTIONAL) @ 


If you use physical highlights, leave logical highlights blank. You 
may specify more than one physical highlight. 


Physical highlights display highlights that correspond to the names, 
normal, inverse, high, low, blink and underline, and are only 
effective on a terminal that is capable of displaying the specific 
highlight. If a specific highlight is not possible for a given 
terminal, it may be replaced by another, or not highlighted when that 
terminal is used. 


If your application will be used on a single terminal type, physical 
highlights give you absolute control over highlighting styles, and 
thus, allow you to define, in detail, the visual effects for the 
screens displayed by your application. 


(OPTIONAL) 


Background color is the color behind the displayed characters or 


graphics. @ 


Foreground color is the color of the characters and lines displayed. 


When you define color attributes, the selected color is only 

displayed on terminals capable of displaying color. If the terminal 

which displays your screen is not color-capable, the color attribute & 
is ineffective. 
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(REQUIRED) 


specify how data can be input or output for this variable. 


The Input/Output modes are: 


Input - Data for the variable can only be entered by the 
end user. The data is not displayed. 


Input/output - The default. Data for the variable can be 
entered or changed by the user, and can also be 
changed by the program. The data is displayed. 


Out put - Data for the variable can only be changed by the 
program. The data is displayed and the field is 
protected. 


(REQUIRED) 


When uppercase mode is selected, any text that is entered by the 


application user is converted to upper case before it is processed by 
the application program. Select one of the following: 


Yes — Text is converted to uppercase. 


No - Text is not converted to uppercase. 


(OPTIONAL) 


© Specify the maximum number of characters for the variable. This 
number must be at least the size of the area on the screen that the 
variable occupies. However, the number can be larger than the size 
of the area defined on the screen for the variable, in which case, 
the screen user must use scrolling to see all of the data. 


(OPTIONAL) 


Applies to variable data that is displayed within a boxed area. This 


is called a textbox. This attribute is ignored for all other 
variable types. 


You must specify what action is to be taken when data sent to the 
variable reaches the right boundary of a line within the textbox. 
You can specify whether the data should wraparound to the next line 
on a word, or on a character. The choices are: 


Word - When output text is sent to a line in a textbox, the 
system determines whether the next string of 
non-blank characters will be split at the end of the 
line. If so, the system searches backward to find 

| the previous blank character, ends the line at the 
& blank character and then sends the string of 
non-blank characters to the next line. Words will 
not be split when word wrap is specified. If using 
word wrap, the variable must be large enough to 
contain the longest word that will be displayed. 
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Character - When output text is sent to a line in a textbox, the 
line is filled with exactly the number of characters 
it can hold. The next line is started with the next 
character of text. Words can be split when character 
wrap is specified. 


Defining Attributes for a Numeric Variable 


The Define Attributes screen for a numeric variable is presented for 
defining, changing or viewing the attributes for a numeric variable. 


If the variable is on a screen that will be used by a FORTRAN 
application, you can also define the output format for the variable. 
Another screen called the Define FORTRAN Format screen is provided for 
defining the FORTRAN output format definition. 


A variable is any character or numeric data whose value can be changed by 
the user, a program or both. There are two types of numeric variables: 


Integer - A whole number within defined value limits. 
Real - A real (floating point) number for computational use. 


Attributes can be defined for a numeric variable to specify the variable 
type, display characteristics, and input/output mode. The output format 
definition includes the format type, whether the field will be signed, 
whether zeroes are to be suppressed and the number of digits. 


To define a numeric variable: 
1. MARK the area to be defined as a numeric variable. 
2. Press the DEFINE function key. 


3. When the Choose Data Type overlay is displayed, press the NUMVAR 
function key. The Define Attributes screen is displayed. 


After completing the screen, do one of the following: 


1. If the screen will be used by a COBOL or CYBIL application program, 
press the FINISH key. The screen is displayed again with an 
underline highlighting the area that was marked and defined for the 
variable. 


2. If the screen will be used by a FORTRAN application program, the 
output format must be specified for numeric variables associated with 
the screen. You can either enter the output format or apply the 
defaults supplied by Screen Formatting. 


To apply the default output format definitions, press the FINISH 

key. The defaults are applied and the screen is displayed again with 
an underline highlighting the area that was marked and defined for 
the variable. 


To enter the output formt for the variable, press the FORMAT key. 
The Define FORTRAN Format screen is displayed. 
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To view or change existing definitions: 


1. Mark a field that is already defined as a numeric variable. 


2. Press the DEFINE function key. The Define Attributes screen is 
displayed with the existing definitions shown. 


To exit the screen, you can either: 


@ Press the FINISH key to signal completion of defining attributes. You 
are returned to the User Edit screen. Any defined highlights are 
activated and displayed on the screen. 


® Press the CANCEL key; the DEFINE function is cancelled and you are 
returned to the User Edit screen. 


® Press the FORMAT function key. 


The Define Attributes screen for a numeric variable is shown below: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
EDIT DEFINE ATTRIBUTES 
->DEF INE Numeric Variable 


@ Attribute Value(s) 
Name: 

Variable type: _integer real 
Logical highlights: normal italic title input error _message 
Physical highlights: normal inverse high low blink underline 
Background color: _ black _blue _green _magenta _ red _cyan _yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
1/0 mode: _input input/output _ output 


Fill appropriate blanks 
Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 
Press TABLE, if shown, to see table definition 
Press FORMAT, if shown, to specify output format 


The items on the screen are described next. 


(REQUIRED) 


@ Enter a name to be assigned to this variable. The name must comply 
with the naming conventions of the programming language used for the 
application. A variable name may have one or more occurrences on a 
screen. However, when it has more than one occurrence, it must be a 
member of a table. 
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(REQUIRED) 


Specify the type of numeric vaiable. There are two types: 


Integer- The default. A positive or negative whole number. 


Real - A floating point number. 


(OPTIONAL) 


If you use logical highlights, leave physical highlights blank. You 
may only select one logical highlight. 


Logical highlights enable you to define physical highlighting styles 


without regard for the types of terminals that will display the 
screen. 


Each NOS/VE site can predefine, in the Terminal Definition Utility 
(TDU) up to six highlighting styles for each terminal type in use at 
the site. In the TDU these highlights have the logical names of 
normal, italic, title, input, error and message. The physical 
highlights actually displayed are controlled by how these names are 
defined in the TDU. 


For example, italic may be defined as inverse video in the TDU for 
one terminal type. For a terminal that cannot display inverse video, 
italic may be defined as underline. The effect is that, regardless 
of terminal type, some form of highlighting can be applied. When 
defining logical highlights, you should be aware of the definitions 
in the TDU. 


When you specify logical highlights, screen definitions do not ever 
need to change to be usable on different terminals. The association 
of a logical highlight to an actual highlight can change simply by 
creating a new terminal definition in the TDU. 


(OPTIONAL) 


If you use physical highlights, leave logical highlights blank. You 
may select more than one physical highlight. 


Physical highlights display highlights that correspond to the names, 
normal, inverse, high, low, blink and underline, and are only 
effective on a terminal that is capable of displaying the specific 
highlight. If a specific highlight is not possible for a given 
terminal, it may be replaced by another, or not highlighted when that 
terminal is used. 


If your application will be used on a single terminal type, physical 
highlights give you absolute control over highlighting styles, and 
thus, allow you to define, in detail, the visual effects for the 
screens displayed by your application. 


COPTIONAL) 


Background color is the color behind the displayed characters or 
graphics. 


Foreground color is the color of the characters and lines displayed. 
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When you define color attributes, the selected color is only 
displayed on terminals capable of displaying color. If the terminal 
which displays your screen is not color-capable, the color attribute 
is ineffective. 


(REQUIRED) 


Specify how values can be input or output for this variable. 
The Input/Output modes are: 


Input - Values for the variable can only be entered by the 
user. The values entered are not displayed. 


Input/output - The default. Values for the variable can be 
entered or changed by the user, and can also be 
changed by the program. The values entered are 
displayed. 


Out put - Values for the variable can only be changed by the 
program. The value is displayed. 


When the user of the screen enters data, the following conversion occurs: 


e Integer numbers are truncated. For example, the number 2.5 is 
converted to 2. 


& A real number is converted to a floating point number. For example, 
an entry of 2.5 is converted to 2.5E3. 


Defining the FORTRAN Output Format 


The Define FORTRAN Format screen is presented for specifying the output 
format for a numeric variable that is accessed by a FORTRAN application. 


The screen is accessed by pressing the FORMAT function key after you 
complete the items on the Define Attributes screen for a numeric variable. 


You do not have to define the FORTRAN output format. When you complete 
the items on the Define Attributes screen for a numeric variable, you can 
press the FINISH key and the defaults are used. The defaults are 
indicated in the discussion of the output format items shown on the 
screen later in this section. 


When the Define FORTRAN Format screen is presented, the name of the 
variable and the maximum width of the variable are automatically 
displayed at the top of the screen. The maximum width is the number of 
characters that were marked for the variable. 


The screen has two sections for specifying the output format: one for an 
integer variable and one for a real variable. 


An integer variable can only have the I format and you can specify 
whether or not the value should always contain a sign character. Two 
values are requested to complete the definition: the total width of the 
formatted variable (including any sign character) and the minimum number 
of output digits. 
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A real variable can have either a E, F, or G format and you can specify 
whether or not the value should always contain a sign character and 
whether or not to suppress leading zeroes. Two values are requested to 
complete the definition: the total width of the variable (including any 
sign characters) and the number of digits to the right of the decimal 
point. An optional field is available to specify the number of digits in 
the exponent field if an exponent field is to be included. 


To exit the screen, you can either: 


e Press the FINISH key to signal completion of defining attributes. A 
cursory validity check will be performed and then the definition is 
forwarded to Screen Formatting. You are returned to the User Edit 
screen. Any defined highlights are activated and displayed on the 
screen. 


e Press the CANCEL key; the DEFINE function is cancelled and you are 
returned to the User Edit screen. 


e Press the BACK key to return to Define Attributes for a numeric 
screen. 


The Define FORTRAN Format screen is shown below: 


EDIT NOS/VE SCREEN DESIGN FACILITY 


SELECT 
DEF INE DEFINE FORTRAN FORMAT 
->FORMAT Numeric Variable 


Name: Maximum width Integer 


Attribute Value(s) 

Output format type: E F Gil 

E,F,G format: Total width Digits right of decimal 
Always signed: _Yes No 


Suppress zero: _Yes No 
Number of digits: in the exponent 

I format: Total width Minimum output digits 
Always signed: _Yes No 


Choose output format type and fill appropriate blanks 


Type any character next to list choices 
Press FINISH when completed, or CANCEL to cancel 


a 


The items on the screen are described below: 


You cannot enter anything in these fields. The name and the maximum 
width of the variable are automatically displayed when the screen is 
presented. The maximum width is the width of the field you marked. 
The variable type (INTEGER or REAL) is indicated at the end of the 
field. 
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(REQUIRED) 
Specify the format type for the variable. The choices are: 
E - Floating point with exponent. Real variables only. 
@ F -— Floating point without exponent. Real variables only. 


G ~ Floating point with or without exponent. Real variables only. 


I - Decimal integer. Integer variables only. 


(REQUIRE D) 


Complete for real variables only. Enter the total width of the 
formatted variable (including any sign character), and the number of 
digits to appear at the right of the decimal point. 

The defaults are: 


Total width = Number of characters marked for the variable. 
Digits right of decimal = one half the width, minus l. 


(REQUIRED) 


Complete for real or integer variables. Specify whether or not the 
variable should always contain a sign character. 


@ The default is: 


Sign character only appears if the value is negative (minus sign). 


(OPTIONAL) 


Complete for real variables only. Specify whether or not leading 
zeroes should be suppressed for the variable. 


The default is: 
Suppress zero = yes. For example, 0.0 prints as spaces. 


(OPTIONAL) 


Complete for real variables only. Enter the number of digits in the 
exponent if the variable has an exponent. 


(REQUIRED) 


Complete for integer variables only. Enter the total width of the 
formatted variable (including any sign character), and the minimum 


@ number of output digits. 


The defaults are: 


Total width = Number of characters marked for the variable. 
Minimum output digits = 0. For example, O prints as a space. 
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(REQUIRED) a] 


Complete for integer or real variables. Specify whether or not the 
variable should always contain a sign character. 


The default is: 


Sign character only appears if the value is negative (minus sign). @ 


Defining Attributes for a Table 


The Define Attributes screen for a table is presented for defining or 
viewing the attributes of a table. You cannot change the definitions for 
a table. A description of how to create a table is provided in the 
section titled Creating a Screen. 


A table is an area on the screen containing multiple occurrences of 
variables. A table can have one occurrence of two or more variables, two 
or more occurrences of one variable, or many occurrences of many 


variables. Any variable type can be included in a table. 


After you define a table, individual occurrences of table variables can 
be MOVEd to other locations on the screen. 


A table must be deleted in its entirety. Deleting part of a table causes 
errors in the definitions when the screen is saved. 


NOTE ® 


When a table is deleted, all of the associated variable definitions are 
also deleted. 


To access the screen to define a table: 


1. You must first define as variables, the first occurrences of each 
variable that will be included in the table. Please refer to the 
previous sections, Defining Attributes for a Character Variable and 
Defining Attributes for a Numeric Variable, for information about how 
to define variables. If you need additional information about how to 
create a table, refer to the section Example of Creating a Screen for 
a detailed example of how to create a table. 
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2. Next you must mark the area the table will occupy. There are two 
methods available. You can MARK either: 


a. An area enclosing only the first occurrences of each of the 
variables to be included in the table. Position the cursor on 
the first character of the first variable to be included in the 


table and press the MARK function key. The character is 
& highlighted. Next, position the cursor on the last character of 
the last variable to be included in the table and press the MARK 


function key again. All variables included in the marked area 
are highlighted. For example: 


Enter the Department Number: 


Unmark Erase Sel Copy NoKeys Ruler 
FljMark |F2|Define |F3| Draw |F4} Move |F5 F6] Quit | F7}| Toggle jF8|Center 


With this method, when you access the Define Attributes screen 
for a table you must specify the number of visible occurrences 


for the table, and the maximum number of occurrences that can be 
transferred to the table. 
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b. The entire area you want the table to occupy. This area must 
include the first occurrence of each variable to be included in 
the table, and must extend vertically under the first occurrences 
for as many visible occurrences as you want for the table. 
Position the cursor on the first occurrence of the first variable 
to be included in the table and press the MARK function key. The 
entire variable is highlighted. Next, position the cursor on the 
opposing corner (non-adjacent) from the first highlighted 
variable and press the MARK function key. The entire boxed area 
the table will occupy is highlighted. For example: 


Enter the Department Number: 


NAME 


With this method, the system determines the number of visible 
occurrences and the maximum number of occurrences the marked area 
can contain. When you access the Define Attributes screen for a 
table, you simply press the SYSTEM function key and these values 
are automatically displayed. 


3. Press the DEFINE function key. When the Choose Data Type screen is 
displayed, press the TABLE function key. The Define Attributes 
screen for a table is displayed. 

To view the attributes already defined for a table: 

1. MARK any variable occurrence on the table. 

2. Press the DEFINE function key. 

3. When the Choose Data Type overlay is displayed, press the TABLE 


function key. The Define Attributes screen for a table is displayed 
with the defined attributes shown. 
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To exit the screeen, you can either: 


@ Press the FINISH key to signal completion of defining attributes. You 


are returned to the User Edit screen. Variables defined as table 
occurrences are shown with an underline. 


© Press the CANCEL key; the DEFINE function is cancelled and you are 
returned to the User Edit screen. 


The Define Attributes screen for a table is shown below: 


spF.SOOSO™C~CSS.CS SSS” VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE ATTRIBUTES 

->DEF INE Table 


Attribute Value(s) 


Name: 
Visible occurrences: 
Maximum occurrences: 


Fill appropriate blanks 
Use SYSTEM or REPEAT for defaults 


Press DELETE to remove table definition 
Press FINISH when completed, or CANCEL to cancel 


The attributes are described below: 


NOTE 


If you marked the entire area you want the table to occupy, the values 


for visible and maximum occurrences do not have to be entered. The 
values are automatically displayed on the Define Attributes screen by 


pressing the SYSTEM function key. 


If you only marked an area enclosing the first occurrences for the 


variables to be included in the table, you must enter the values for 
visible and maximum occurrences. 


(REQUIRED) 


Enter a name to be assigned to the table. The name must comply with 
the naming conventions of the programming language used by the 
application accessing the screen. 
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(OPTIONAL) © 


Enter the number of visible occurrences of data that can be displayed 

on this table at one time. There must be enough empty space on the 

screen under the first occurrences for the number of occurrences you 

specify. If this number is less than the maximum number of 

occurrences that can be transferred to the table at one time, the 

user must use the scrolling and paging keys to see all of the data. & 


(OPTIONAL) 


Enter the maximum number of occurrences of data that can be 
transferred to this table at one time. This number can be greater 
than the visible occurrences, but not fewer. If you use the SYSTEM 
function to calculate this number, it can be increased but not 
decreased. 


Defining Attributes for a Box or Line 


The Define Attribute screen for a box or line is presented for defining 
or changing the attributes of a box or line. 


A box or line is generally used to: denote where data is to be entered by 
the user; provide a fixed area on the screen where the program can 


display data; frame a screen; or decorate a screen. 


The only attributes that can be assigned to a box or line are display 
characteristics such as intensity, color and line width. @ 


To access the screen: 
1. The box or line must be drawn using the MARK and DRAW functions. 


2. Position the cursor anywhere on the box or line and press the MARK 
function key. The box or line is highlighted. 


3. Press the DEFINE function key. 


To exit the screen, you can either: 


e Press the FINISH key to signal completion of defining attributes. 
You are returned to the User Edit screen. 


Any defined highlights are activated and displayed on the screen. 


e Press the CANCEL key. The DEFINE function is cancelled and you are 
returned to the User Edit screen. 
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@ The Define Attributes screen for a box or line is shown below: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
& EDIT DEFINE ATTRIBUTES 
—->DEF INE Box or Line 
Attribute Value(s) 
Name: 
Intensity: _normal high _low 


Color: _black blue green magenta red cyan yellow white 
Line width; _fine medium _bold 


Fill appropriate blanks 

Type any character next to list choices 

Use SYSTEM or REPEAT for defaults 

Press FINISH when completed, or CANCEL to cancel 


The attributes are described below. 


(OPTIONAL) 
Enter a name for the box or line. 

(OPTIONAL) 
The brightness of the box or line. 

(OPTIONAL) 
The color of the box or line when displayed. 

(OPTIONAL) 


The thickness of the lines to be displayed. 
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Drawing a Box or Line 
(DRAW Function) 


The DRAW function is used to draw lines and boxes on the screen. 


Lines and boxes cannot intersect with other lines or boxes or with other 
fields on the screen. An error is displayed if this is attempted. 


Drawing a Horizontal or Vertical Line 


1. Position the cursor at one end (beginning or ending location) of 
where you want the line to appear, and press the MARK function key. 
The marked position is highlighted. 


2. Position the cursor at the other end of the line, and press the DRAW 
function key. The line is drawn. 


Alternatively, you can MARK both ends of where you want the line to be 
drawn and then press the DRAW function key. 


Drawing a Box 


1. Position the cursor at one corner of where you want the box to be 
drawn, and press the MARK function key. The marked position is 
highlighted. 


2. Position the cursor at the opposing (non-adjacent) corner of where 


you want the box to be drawn, and press the DRAW function key. The 
box is drawn. 


Alternatively, you can MARK both of the opposing corners of where you 
want the box to be drawn, and then press the DRAW function key. 


After you have drawn a line or box, you can specify the intensity, color 
and width of a line or the lines surrounding the box. You simply 
position the cursor anywhere on the line and press the MARK function 
key. Then press the DEFINE function key. The Define Attributes screen 
for a box or line is displayed. 


Erasing a Field 
(ERASE Function) 


The ERASE function erases a field on the screen. The area to be erased 
must completely contain fields, but cannot split a field. Defined 
attributes for an erased field are also erased. 


The erased area becomes an empty area on the screen and can be reused. 


NOTE 
A table must be erased in its entirety. Erasing part of a table causes 


errors in the definitions when the screen is saved. When a table is 
erased, all of the associated variable definitions are also erased. 
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To erase a field: 


1. MARK the field to be erased. Refer to the MARK function described in 
this section of the manual. 


2. Press the ERASE function key. The field is erased and the area 
becomes blank. 


Marking a Field 
(MARK Function) 


The MARK function is used to point to the area on your screen on which 
you want to perform an editing function, 


Editing functions which require that you mark the area before initiating 
the function display an error message if no marks are set. 


Any area or any type of field can be marked. However, marks must not 
split defined fields. Whole areas of the screen, containing any type of 
fields, can be marked with an imaginary box, so that an editing function 
can be performed on the entire area as a single unit. 


Areas remain marked until another MARK function is performed, until they 
are UNMARKed, or until a function (other than COPY) using marks is 
initiated. 

Marking a Defined Field 


1. Position the cursor on any character position occupied by the field 


to be marked and press the MARK function key. The field can be 
constant text, a variable, a table variable, a box or line. 


The field is highlighted as follows: 


® If the field is constant text, a variable, or a table variable, the 
defined size of the field is highlighted. 


6 If the field is a text box, the entire boxed area is highlighted. 


e If the field is a line or box, the entire line or box is highlighted. 


Marking an Undefined Field 


1. If marking constant text, a variable, or a line, position the cursor 
on the first or last character of the field to be marked and press 
the MARK function key. The marked character is highlighted. 


Position the cursor on the opposite end of the first mark, and press 
the MARK function key again. 


2. If marking a box, position the cursor on any corner where you want 
the box to begin and press the MARK function key. The marked corner 
is highlighted. 


Position the cursor on the opposing (non-adjacent) corner of the 
first mark, and press the MARK function key again. 
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In either case, the entire marked field is highlighted. You can now 
perform an editing function on the marked field. 


An area can sometimes be marked by using one or two marked fields as one 
or both marks for the new area to be marked. For example, if a vertical 
line is marked, an area of the same height can be marked by positioning 
the cursor to the left or right of the vertical line, and pressing the 
MARK function key again. 


Similarly, an area that is bounded by two defined fields can be marked 
with an imaginary box by marking each of the defined fields. That area 
can then be defined, and if desired, it can be moved or copied with all 
of the defined attributes that are applicable for the enclosed fields. 


Moving a Field 
(MOVE Function) 


The MOVE function moves a field from one location to another location on 
a screen, 


The area you move the field from is left blank; MOVE does not expand or 
compress your existing screen image. 


To move a field: 


1. MARK the field to be moved. Refer to the MARK function described in 
this section of the manual. @ 


2. Position the cursor at the first character of the area where you want 
the marked field to be moved. 


3. Press the MOVE function key. The field is moved to the location 
where the cursor is positioned. 


If you attempt to move a field into an occupied area, SDF issues an error 
message and allows you to retry at a different location, or you can make 


the destination area clear of fields. 


Defined attributes for the moved field are carried along to the new 
location. Marks are cleared after the MOVE function is complete. 


Turning Off Function Key Prompts 
(NOKEYS Function) 


The NOKEYS function turns off the function key prompts displayed at the 
bottom of the screen. 


While editing a screen, you may need to create or change fields in the @ 
area of the screen that is overlayed by these function key prompts. 


To turn off function key prompts: 
Press the NOKEYS function key. @ 
All function keys remain active, even though they are not displayed at 


the bottom of the screen. 
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To display the function key prompts again, simply press the NOKEYS 
function key again. 


Ending an SDF Session 
(QUIT Function) 


The QUIT function ends an SDF session and returns you to NOS/VE. 


If you press the QUIT function key from the Banner screen or from the 
Select screen, you are immediately returned to NOS/VE. 


If you press QUIT after using an editing function on a new or existing 
screen and you have not used the SAVE function, SDF offers you a chance 
to save the screen by overlaying the screen with the following message: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran cde fortran _cybil 


Press the NEXT key to replace an existing screen to which you have made 
changes. Enter a unique name and press NEXT to save a new screen, press 
the BACK key to discard the screen, or press QUIT to exit SDF (the screen 
will also be discarded). 


The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition generated 
for the screen. The language checked is the language specified when you 
defined the screen profile. You can enter any character next to as many 
of the languages as desired. There will be one SCU deck generated for 
each language selected. If no languages are selected, no record 
definitions will be generated. 


If you press QUIT and you have not used an editing function, the message 
is not displayed; the session is ended and the entries are discarded. 


Displaying Character and Line Positions for a Screen 
(ROLER Function) 


The RULER function displays a horizontal and vertical scale on the screen 


you are creating or editing. The scale shows character positions and 
line numbers for the screen. 


While the screen remains visible, the scale appears as foreground, giving 
your terminal display a two-dimensional appearance. 


The scale intersects at the position of the cursor when you initiate the 
RULER function. 
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To display the scale: 


1. Position the cursor at the point where you want the horizontal and 
vertical lines to intersect. 


2. Press the RULER function key. 


At the position where the scale intersects, the fields on the screen are 
overlayed; the fields are still there, but not visible. You can move the 
scale at anytime by positioning the cursor on another area and pressing 
the RULER function key. 


To remove the scales from the screen, you can either: 


e Press the RULER function key twice in succession without moving the 
cursor, or 


e Position the cursor at the position where the scales intersect, and 
press the RULER function key. 


Executing an SCL Command 
(SCL Function) 


While editing or creating a screen, the SCL function enables you to 
interrupt editing and execute NOS/VE SCL commands. 


To execute an SCL command: 


1. Press the SCL function key. This creates a command line at your 
terminal”~s HOME line. The cursor is positioned on the first 
character position of the command line. 


2. Type the SCL command, and press the NEXT key. The command is 
executed. 


When all of the output from the command has been displayed at your 


terminal, a message is displayed prompting you to return to your edit 
session by pressing the NEXT key. 


Displaying Function Key Prompts 
(TOGGLE Function) 


The TOGGLE function displays, at the bottom of the User Edit screen, the 
editing functions available. There are two sets of editing functions, 
MAIN editing functions and SECONDARY editing functions. 


Only one set of these function key prompts are displayed at a time. To 
use a given function, it must be displayed at the bottom of the 
screen.You can toggle between the main and secondary editing functions at 


will, simply by: 


Pressing the TOGGLE function key. 
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Cancelling Editing Changes 
(UNDO Function) 


The UNDO function cancels the effects of the last editing function you 
performed. Only the last editing function can be cancelled. 


If you discover, after making an editing change, that the change is not 
desirable or in error, the UNDO function cancels the editing change and 
returns the screen to its state before the editing change was initiated. 
To UNDO editing changes: 

Press the UNDO function key. 


The screen image is changed back to its state prior to the previous 
editing function you performed. 


Unmarking a Field 
(UONMARK Function) 


The UNMARK function clears all MARKed fields or areas on the screen. 
To unmark an area: 
Press the UNMARK function key. 
@ Fields or areas on the screen highlighted by the MARK function are 


returned to their original state; with any previously displayed 
highlights restored. 
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Secondary Editing Functions 


Defining Screen Attributes 
(ATTRIB Function) 


The ATTRIB function is used to access the Define Attribute Groups 
screen. This screen is used to define or delete attributes that can be 
used dynamically by the application program to temporarily highlight a 
field on a screen. For example, these attributes can be called in the 
application program by the name you have specified to temporarily 
highlight a field when an error condition occurs when data is entered in 
the field. 


You may define as many attributes as desired for the screen. To do so 
you must access this screen for each definition. To access the screen: 


1. If the secondary function key prompts are not displayed, press the 
TOGGLE function key. 


2. Press the ATTRIB function key. 


The Define Attribute Groups screen shown below is displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY 


SELECT 
EDIT DEFINE ATTRIBUTES 
->ATTRIBUTE Define Attribute Groups 


Attribute Value(s) 

Name; 

Logical highlights: italic title input error message 
Physical highlights: inverse high low blink underline 


Background color: _black blue green magenta red cyan yellow white 
Foreground color: _black blue green magenta red cyan yellow white 
Line Width: _fine medium _ bold 


Special attributes: “protect hidden 


Fill appropriate blanks 
Type any character next to list choices 

For DELETE - only the name is required 

Press FINISH when completed, or CANCEL to cancel 

To display all attribute definitions, CANCEL, then use SEEDEF 


To complete the items on the Define Attribute Groups screen, enter 


any character next to your choice on the screen. The selected 
attributes will be associated with the name you entered. 


After completing the screen, press the FINISH function to complete 


the definitions. The definitions are processed and you are returned 
to the User Edit screen. 
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To delete an existing definition, you simply enter the name of the 
definition after NAME: and press the DELETE function key. The 
request is processed and you are returned to the User Edit screen. 


Pressing the CANCEL function key will return you to the User Edit 
screen with no changes made to the attributes defined for the screen. 


& The items on the Define Attribute Groups screen are described next. 


(REQUIRED) 


Enter a name to be associated with the attributes defined on this 
screen. The name will be used by the application program to call the 
defined attributes. The name must comply with the naming conventions 
of the programming language used for the application. 


(OPTIONAL) 


If you use logical highlights, leave physical highlights blank. You 
may only specify one logical highlight. 


Logical highlights enable you to define physical highlighting styles 
without regard for the types of terminals that will display the 
screen. 


Each NOS/VE site can predefine, in the Terminal Definition Utility 
(TDU) up to six highlighting styles for each terminal type in use at 
the site. In the TDU these highlights have the logical names of 


italic, title, input, error and message. The physical highlights 
@ actually displayed are controlled by how these names are defined in 
the TDU. 


For example, italic may be defined as inverse video in the TDU for 
one terminal type. For a terminal that cannot display inverse video, 
italic may be defined as underline. The effect is that, regardless 
of terminal type, some form of highlighting can be applied. When 
defining logical highlights, you should be aware of the definitions 
in the TDU. 


When you specify logical highlights, screen definitions do not ever 
need to change to be usable on different terminals. The association 
of a logical highlight to an actual highlight can change simply by 
creating a new terminal definition in the TDU. 


(OPTIONAL) 


If you use physical highlights, leave logical highlights blank. You 
may specify more than one physical highlight. 


Physical highlights display highlights that correspond to the names: 
inverse, high, low, blink and underline, and are only effective on a 
@ terminal that is capable of displaying the specific highlight. If a 
specific highlight is not possible for a given terminal, it may be 
replaced by another, or not highlighted when that terminal is used. 


If your application will be used on a single terminal type, physical 
highlights give you absolute control over highlighting styles, and 
thus, allows you to define, in detail, the visual effects for the 
screens displayed by your application. 
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Background color is the color behind the displayed characters or 
graphics. 


Foreground color is the color of the characters and lines displayed. 


When you define color attributes, the selected color is only 
displayed on terminals capable of displaying color. If the terminal 
which displays your screen is not color-capable, the color attribute 
is ineffective. 


(OPTIONAL) 


The width of the line used for graphic fields - lines and boxes. 


cocnhemeacarnansstn 


(OPTLONAL) 


This attribute is used to indicate special conditions for data 
entered on a screen, 


PROTECT -— May be used to temporarily freeze the contents of an 
input/output field so that the user cannot change the 
field until this attribute is removed. 


HIDDEN - May be applied to fields where the input value should 
not remain visible on the screen after being entered. 


Defining Function Keys 
(EVENTS Function) 


The EVENTS function enables you to define function keys for the screen 


you are creating or editing. You are presented with the Define Function 
Keys screen on which you specify the program event name, key assignment, 
menu label and the action to be taken when the key is pressed. Refer to 
the Screen Formatting Usage manual for more information about defining 
function keys. 


Only nine (9) function key assignments can be entered on the Define 
Function Keys screen. If you have more than nine events to define, you 
can use the paging and scrolling terminal keys (FWD, BKW, UP and DOWN) to 
enter more assignments. 


To define function keys: 


l. If the secondary function key prompts are not displayed, press the 
TOGGLE function key. 


2. Press the EVENTS function key. 
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The Define Function Keys screen shown below is displayed: 


SDF NOS/VE SCREEN DESIGN FACILITY 
SELECT 
EDIT DEFINE FUNCTION KEYS 

->EVENTS 


Program event name Key assignment Menu label Action 


TTT 


Type values in blanks; label, menu label is optional 
Use paging/scrolling keys for more key definitions 
Press DELETE to remove key definition 

Press FINISH when completed, or CANCEL to cancel 


The functions at the bottom of the screen are described in the section 


® Functions on the Define Screens. The items on the screen are described 
below: 


(REQUIRED) 


A name by which the application program refers to this function key. 
This name must follow the naming conventions of the programming 
language used by the application program. 


(REQUIRED) 


A mnemonic name specifying the function key to be assigned. The 
valid key assignments are listed below. The assignments that begin 
with the letter s represent assignments in the shifted mode. 


next, help, stop, back, up, down, fwd, bkw, undo, redo, quit, 
exit, first, last, edit, data, fl, £2, £3, £4, £5, f6, f7, £8, 
£9, £10, fll, £12, £13, £14, £15, £16, snext, shelp, sstop, 
sback, sup, sdown, sfwd, sbkw, sedit, sdata, sfl, sf2, sf3, sf4, 
sf5, sf6, sf7, sf8, sf9, sfl0, sfll, sf12, sf13, sf14, sf15,, 
sf16, pick, insl, dell, home, clear. 


(OPTIONAL) 


A 1 to 6 character name for the key. The name is the label displayed 
on the function key prompt line. If not specified, the key is still 
active, but will not be displayed at the bottom of the screen. 
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(OPTIONAL) 


A mnemonic name indicating the action to be taken by Screen 
Formatting when this key is pressed. For additional information, 
refer to the Screen Formatting Usage manual. 


Enter one of the following: 


normal, abnormal, table fwd, table_bkw, table_up, table_down, 
varible fwd, variable_bkw, tab_next, tab prior. 


These actions are described below: 
normal 


The application program will process data entered by the 
terminal user. Normal is the default. 


abnormal 


The program will not process data entered by the terminal 
user. The program will usually delete the screen from the 
display and move on to other processing. The program can use 
an abnormal event to help a terminal user supply data for a 
particular variable. 


table_fwd 


Causes the next page of a table to be displayed. A page is 
the number of visible occurrences on a table. The event is 
handled by Screen Formatting and is not passed to the 
application program. 


table_bkw 


Causes the previous page of a table to be displayed. The 
event is handled by Screen Formatting and is not passed to 
the application program. 


table _up 


Causes the table occurrence under the cursor to move to the 
first visible occurrence on the table. The event is handled 
by Screen Formatting and is not passed to the application 
program. 


table_down 


Causes the table occurrence under the cursor to move to the 
last visible occurrence on the table. The event is handled 
by Screen Formatting and is not passed to the application 
program. 


variable fwd 


Causes the variable at the cursor position to scroll 
forward. When the event occurs, the character at the cursor 
position becomes the first character the terminal user sees 
in the variable field. The event is handled by Screen 
Formatiing and is not passed to the appplication program. 
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variabl e_bkw 


Causes the variable at the cursor position to scroll 
backward. When the event occurs, the character at the cursor 
position becomes the last character the terminal user sees in 
the variable field. The event is handled by Screen 
Formatting and is not passed to the application program. 


tab_next 


Moves the cursor to the next input variable on the screen. 

If the cursor is currently positioned at the last variable on 
the screen, this event causes the cursor to move to the first 
input variable on the screen. The input variables are 
ordered left to right, top to bottom on the screen. 


tab_prior 


Moves the cursor to the previous input variable on the 
screen. If the cursor is currently positioned at the first 
variable on the screen, this event causes the cursor to move 
to the last input variable on the screen. 


Screen Formatting updates the screen data for a normal event, but does 
not if the event is abnormal. Both normal and abnormal events are 
reported to the application program. When paging and scrolling actions 
are used, Screen Formatting will do the paging automatically, and the 
application program is not notified of the event. The same is true for 
tab actions, which automatically tab to input fields on the screen. 


Ending an SDF Session 
(QUIT Function) 


The QUIT function ends an SDF session and returns you to NOS/VE. 


If you press the QUIT function key from the Banner screen, or from the 
Select screen, you are immediately returned to NOS/VE. 


If you press QUIT after using an editing function on a new or existing 
screen and you have not used the SAVE function, SDF offers you a chance 
to save the screen by overlaying the screen with the following message: 


Press NEXT to replace existing screen. 
Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran _cde fortran _cybil 
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Saving a Screen 


Press the NEXT key to replace an existing screen to which you have made 
changes. Enter a unique name and press NEXT to save a new screen, press 
the BACK key to discard the screen, or press QUIT to exit SDF (the screen 
will also be discarded). 


The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition generated 
for the screen. The language checked is the language specified when you 
defined the screen profile. You can enter any character next to as many 
of the languages as desired. There will be one SCU deck generated for 
each language selected. If no languages are selected, no record 
definitions will be generated. 


If you press QUIT and you have not used an editing function, the message 
is not displayed; the session is ended and the entries are discarded. 


Saving a Screen 
(SAVE Function) 


The SAVE function saves the screen you are creating or editing; the 
screen is saved in the library specified on the DESS command when you 
signed on to SDF, or if no library was specified, it is saved in the 
default library SCREEN LIBRARY in your current working catalog. 


To save a screen: 


1. If the secondary function key prompts are not displayed, press the 
TOGGLE function key. 


2. Press the SAVE function key. The following is displayed: 


Press NEXT to replace existing screen. 


Enter unique name, press NEXT to save new screen. 
Press BACK to discard screen, QUIT to exit SDF. 


Record definition output will be produced in 
_cobol _ansi fortran _cde fortran _cybil 


Press the NEXT key to replace an existing screen to which you have made 
changes. Enter a unique name and press NEXT to save a new screen, press 
the BACK key to discard the screen, or press QUIT to exit SDF (the screen 
will also be discarded). 


The line at the bottom of the overlay is provided for indicating the 
programming languages for which you want a record definition generated 
for the screen. The language checked is the language specified when you 
defined the screen profile. You can enter any character next to as many 
of the languages as desired. There will be one SCU deck generated for 
each language selected. If no languages are selected, no record 
definitions will be generated. 
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Saving a Screen 


After you use the SAVE function, the system checks the screen definitions 
for conflicts or inconsistencies that were not detected while editing. 
If any errors exist, you are presented with the following screen: 


@ Screen Definition Errors 


—(error message) 


e 
e 


Use paging keys to see all errors 
Press NEXT to return 


& The Screen Definition error screen contains information about each 
error encontered in the screen definition. When you have looked at 


all of the errors, you can return to the User Edit Screen by pressing 
the RETURN key. 


You can fix the errors on the screen and resave the screen. If you 
do not fix the errors, the screen will not be saved and the screen 
record definition will not be written to your source library until 
the screen definition is free of errors. 


If the error is either a duplicate or blank screen name, the save 
overlay is displayed again enabling you to fix the name problen. 
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Executing an SCL Command 


Executing an SCL Command 
(SCL Function) 


While editing a screen, the SCL function enables you to interrupt editing 
and execute NOS/VE SCL commands. 


To execute an SCL command: 


1. Press the SCL function key. This creates a command line at your 
terminal”s HOME line. The cursor will be positioned on the first 
character position of the command line. 


2. Type the SCL command, and press the NEXT key. The command is 
executed. 


After the command has been executed, a message is displayed prompting you 
to press the NEXT key to return to your edit session. Press the NEXT 
key; you are returned to SDF with the edit screen displayed. 


Displaying the Screen Definitions 
(SEEDEF Function) 


The SEEDEF function overlays the User Edit screen with a window showing 
all of the characteristics defined for the screen. This information 
consists of the screen name (if any), the programming language, 
background and foreground color, border size, width, height and column 
and line origin. These items were defined on the Define Screen Profile 
screen. 


In addition, the display shows the attributes defined by the ATTRIB 
function. These attributes can be used by the application program to 
dynamically change the display characteristics of a field, for example, 
to indicate an error condition during processing of the field. To 
display the screen definitions do the following: 


1. If the secondary function key prompts are not displayed, press the 
TOGGLE function key. 


2. Press the SEEDEF function key. 
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Displaying the Screen Definitions 


An example of the screen definition display is shown below: 


Screen Name: myscreen 
Language: Cobol 
Background: Black 
Foreground: White 
Border: None 

Width: Full Screen 
Height: Full Screen 


Column Origin: 1 
Line Origin: 1 


Attribute List: 1 defined for this screen. 

Name: one 

Attributes: black background, white foreground,error. 
End of list 


To remove the screen definitions from the screen, press the NEXTkey. 


The information on the display is: 
screen Name 


The name of the screen. If it is blank, the screen is still 
being created and has not yet been named. 


Language 
The application language (COBOL, FORTRAN or CYBIL). 
Background 
The background color of the screen. 
Foreground 
The color of the characters on the screen. 
Border 
_ The thickness of the border (Fine, Medium, Bold or None). 
Width 
The width of the screen in characters. If Full Screen is 
© indicated, the screen is defined to be the size of the terminal 


on which the application is running. If values are displayed, 
the screen size is fixed. 
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Displaying the Screen Definitions 


Height = 


The height of the screen in lines. If Full Screen is indicated, 


the screen is defined to be the size of the terminal on which the 
application is running. If values are displayed, the screen size 
is fixed. 


Column Origin © 


The column in which the left side of the screen will be 
positioned when displayed. 


Line Origin 


The line in which the top of the screen will be positioned when 
displayed. 


Attribute List 


A list of all the screen attributes defined with the ATTRIB 

function. These are display attributes that can be called by 
name by the application program at any time. Scrolling may be 
necessary to see the whole list. The COUNT indicates how many 


attributes are defined. Examples of the three possible attribute 
list formats follows: 


(1) Attribute List: None defined for this screen. 


Attribute List: 1 defined for this screen. r 
Name: AAA 

Attributes: Black background, white foreground, error. 

End of list 


| 


Attribute List: 2 defined for this screen. 


Name: AAA 
Attributes: black background, white foreground, error. 
Name: BBB 


Attributes: Blue background, magenta foreground, 
protect, blink. 


Only one of these formats is displayed. 
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Displaying a Screen While Editing 
(SHOW Function) 


The SHOW function displays the screen you are editing. 


When the screen is displayed it looks exactly the way it will look to the 
end user; in the assigned location and with all of the visual effects 
(highlighting) and function key prompts you have defined for the screen. 


To display a screen: 


l. If the secondary function key prompts are not displayed, press the 
TOGGLE function key. 


2. Press the SHOW function key. The screen is displayed. 


To remove the screen from the dispay, press the NEXT key. 


Displaying Function Key Prompts 
(TOGGLE Function) 


The TOGGLE function displays, at the bottom of the User Edit screen, the 
editing functions available. There are two sets of editing functions, 
MAIN editing functions and SECONDARY editing functions. 


Only one set of these function key prompts are displayed at a time. To 
use a given function, it must be displayed at the bottom of the screen. 


You can toggle between the main and secondary editing functions at will, 
simply by: 


Pressing the TOGGLE function key. 
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Glossary A 


A 


Attribute 


A property of a screen, variable, table of variables, object or 
constant that is needed to process a form. 


C 


Catalog 


A directory of files maintained by the operating system for a user. 
In addition to files, a catalog can contain other catalogs. 


E 


Event 


A property of a screen that is defined when the screen is created and 
is referenced by the application program. 


F 


Field 


Can be constant text, a variable, box or line drawing, or a table 
that contains one or more occurrences of one or more variables. 


Full Screen Application 


A program that utilizes the entire terminal screen to display the 
data and/or user’s options. The user can move the cursor around the 
screen to input and modify data or to indicate which function to 
execute. 


Function 
An instruction to a full screen program. If function keys are 
available on the keyboard, the user can press a function key to 
execute a function. 

Function Key 
A key on a keyboard that is used to execute a function. Function 
keys are often labelled with an F and a digit. For example, Fl, F2, 
or F3. 

Function Key Prompts 
The association of functions with the function keys on the user’s 


keyboard. In most full screen programs, the function key assignments 
are displayed at the bottom of the screen. 
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Glossary 


e 


Occurrence 


The number of times a variable appears on the screen. 


P 6 


Program 


A set of instructions or actions that provides an interface between a 
user and the computer. 


Protected and Unprotected Fields 


Protected fields are fields that cannot be changed by the terminal 
user. Unprotected text can be changed by the terminal user. 
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Related Manuals B 


Table B-1 lists all manuals that are referenced in this manual or that 
contain background information. A complete list of NOS/VE manuals is 
given in the SCL Language Definition manual. If your site has installed 
the online manuals, you can find an abstract for each NOS/VE manual in 
the online System Information manual. To access this manual, enter: 


explain 


Table B-l. Related Manuals 


Publication 
Manual Title Number Online Title 
Terminal Definition 60464016 
for NOS/VE Usage 
Screen Formatting 60488813 
Usage 
NOS/VE System 60464014 
Usage 
Context Usage Manual 60488403 CONTEXT 


Ordering Printed Manuals 


You can order Control Data manuals through Control Data sales offices or 
through: 


Control Data Corporation 

Literature and Distribution Services 
308 North Dale Street 

St. Paul, Minnesota 55103 


Accessing Online Manuals 


To access an online manual, log in to NOS/VE and specify the online 
manual title (listed in table B-1) on the EXPLAIN command. For example, 
to read the Screen Design Facility online manual, enter: 


explain manual=SDF 
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@ Accessing SDF 2-1] 


Accessing the online manual 
LEARN function 3-2 
HELP facility 1-3 

ACTION: 3-78 

Application program 1-1 

Attributes, defining 3-44 

ATTRIB function 3-74 


B 


BACK key 1-11 
BACKGROUND COLOR: 3-49 
BANNER screen 3-1 
functions 3-2 
BKW key 1-12 
Boxes and Lines 
Defining 3-66 
Drawing 3-68 
Drawing example 3-28 


Cc 


Cancelling a DEFINE function (CANCEL) 3-47 
Cancelling a DELETE function (UNDO) 3-39 
Cancelling an editing function (UNDO) 3-73 
Centering a field (CENTER) 3-43 
Changing a screen profile (PROFIL) 3-40 
Changing and viewing attributes 3-45 
Choosing a data type 3-44 
Choosing a session type 3-1 
Color 

Background 3-49 

Defining 3-49 

Foreground 3-49 
COLOR: 3-6/7 
Commmand line 1-7, 12 
Constant text 

Defining 3-49 

Example 3-11 
Context block 1-8 


Conventions 1-/ 
€ Copying a field (COPY) 3-43 


Copying attributes (REPEAT) 3-46 
Creating a screen (CREATE) 3-5 
Creating a table 3-20 
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Index 


D 


Data types 3-10 
Defining a screen profile 3-5 
Defining attributes 
Define Attributes screens 1-9 
DEFINE function 3-44 
Defining a box or line 3-66 
Defining a new field 3-44 
Defining a table 3-62 
Defining a character variable 3-52 
Defining a numeric variable 3-56 
Defining constant text 3-49 
Functions on DEFINE screens 3-46 
Using the DEFINE function 3-44 
Defining function keys 3-76 
Defining screen attributes 3-7/4 
DELETE function 
Deleting a function key definition 3-47 
Deleting a screen 3-39 
Deleting a table definition 3-47 
Deleting screen attributes 3-75 
DESS command 2-1 
Displaying 
A sereen (SHOW) 3-39, 85 
The screen definition (SEEDEF) 3-82 
Character and line positions (RULER) 3-71 
Editing functions 3-72 
DOWN key 1-13 
DRAW function 3-68 
Drawing a box 3-68 
Drawing a horizontal or vertical line 3-68 


E 


EDIT function 3-3 
Editing a screen 3-32 
Editing functions 
Main 3-43 
Secondary 3-74 
END OF LINE WRAP: 3-55 
Ending an SDF session (QUIT) 3-2 
Erasing a field (ERASE) 3-68 
Error message processing 1-14 
EVENTS function 3-76 
Executing an SCL command 1-/ 
With the HOME key 1-12 
With the SCL function 3-72 


F 


Fields 1-2 

Types of 3-10 
FINISH function 3-46 
FOREGROUND COLOR: 3-49 
FORMAT function 3-4/7 
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Full screen 1-1 

Function key prompts 1-9 

Function keys on the 
Banner screen 3-2 
Define Attributes screens 3-46 
Define Function Keys screen 3-46 
Define Screen Profile screen 3-46 
Select screen 3-5 
User Edit screen 3-43, 74 

FWD key 1-12 


G 


Getting help 
HELP key 1-12 
Help facility 1-13 
Help for the Banner screen 3-2 


H 


Help facility 1-13 

Help for the Banner Screen 3-2 
HELP key 1-13; 3-2 
Highlighting 3-48 

HOME key 1-7, 12 

Home line 1-7, 12 

How to use SDF example 1-3 


Imaginary box 1-10 

Initiating an editing session 3-4 
Instruction lines 1-9 

INTENSITY: 3-67 

Introduction I1-l 

I/0 MODE: 3-55 


K 


KEY ASSIGNMENT: 3-77 
Key prompts 1-9 
Keys 
Function 1-9 
Terminal 1-11 
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Index 


. © 


LEARN function 3-2 
LIBRARY (L) 2-1 
LINE WIDTH: 3-67, 76 
Lines and boxes 
Defining 3-66 
Drawing 3-68 & 
Logical highlights 3-48 
Login 2-1 
Logon Summary 2-3 


M 


Main editing functions 3-8, 43 
Marking 
MARK function 3-69 
Marking a defined field 3-69 
Marking an undefined field 3-69 
MAXIMUM CHARACTERS: 3-55 
MAXIMUM OCCURRENCES: 3-66 
MENU LABEL: 3-77 
MODE(M) 2-1 
Moving 
A line to the bottom of the screen (DOWN key) 1-13 
A line to the top of the screen (UP key) 1-12 
Moving a field (MOVE) 3-70 


N 


NAME: 3-50 

Naming a screen 3-80 
NEXT key 1-11 

NOKEYS function 3-/0 


O 


Occurrences 3-62 
Overview 1-3 


P 


Paging 
Backward (BKW key) 1-12 
Down (DOWN key) 1-13 
Forward (FWD key) 1-12 


Up (UP key) 1-12 
Physical highlights 3-48 
PROFIL function 3-40 


PROGRAM EVENT NAME: 3-77 
PROGRAMMING LANGUAGE: 3-/6 
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Q 


QUIT function 3-2 


REPEAT function 3-46 


Returning to the previous context (BACK key) 1-11 
RULER function 3-71 


S 


Saving a screen (SAVE) 3-80 
Saving attributes (FINISH) 3-46 
Scale, displaying (RULER) 3-71 
SCL function 3-72 
SCREEN BORDER 3-6 
Screen Formatting 1-1; 2-1 
SCREEN HEIGHT: 3-7 
Screen layout 1-/ 
SCREEN NAME (SN) 2-2 
Screen profile 
Defining 3-5 
Displaying 3-40 
Screen title 1-8 
SCREEN WIDTH: 3-6 
SEEDEF function 3-82 
Screens, SDF 
Banner 1-8; 3-1 
Define Attributes 1-9 
Boxes and lines 3-67 
Character variables 3-53 
Constant text 3-50 
Numeric variables 3-57 
Tables 3-65 
Define FORTRAN Format 3-60 
Define Function keys 1-9; 3-77 
Define Screen Attributes 3-74 
Define Screen Profile 1-8; 3-5 
Select 1-8; 3-3, 32 
User Edit 1-8; 3-8 
Secondary editing functions 3-74 
SELECT function 3-32 
Select screen 3-3, 32 
SHOW function 3-39, 85 
SOURCE(S) 2-2 
SPECIAL ATTRIBUTES 3-76 
STATUS 2-2 
SYSTEM function 3-46 


Index 
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Index 


T 


Table occurrences 3-62 
Tables 

Creating 3-20 

Defining 3-62 

TABLE function 3-48 
Terminal Definition Utility 2-1 
Terminal keys 1-11 
Terminal requirements 2-1 
Things to know about highlighting 3-48 
TOGGLE function 3-72 
Turning off function key prompts (NOKEYS) 
Types of data 3-10 


U 


UNDO function 3-39 

Unmarking a field (UNMARK) 3-73 

UP key 1-12 

UPPERCASE MODE: 3-55 

Using system default attributes 
SYSTEM function 3-46 


V 


VARIABLE TYPE: 3-53 
Variables 

Defining character 3-52 

Defining numeric 3-56 
Viewing a Table definition (TABLE) 3-48 
Viewing and changing attributes 3-40 
VISIBLE OCCURRENCES: 3-66 


X 


X-ORIGIN 3-/ 


Y 


Y-ORIGIN 3-7 
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We would like your comments on this manual. While writing it, we made some assumptions about who 
would use it and how it would be used. Your comments will help us improve this manual. Please 
take a few minutes to reply. 


Who Are You? How Do You Use This Manual? Do You Also Have? 

___. Manager ____ As an Overview ___ Screen Formatting 

___. Systems Analyst or Programmer ____ To learn the Product/System Usage 

____ Applications Programmer ____ For Comprehensive Reference __. Terminal Manager 
Operator For Quick Look~up Usage 

a Other oe 


What programming languages do you use? 


en ee te A lh ae 


Which are helpful to you? Table of SDF Functions Related Manuals Appendix 


Other 


a i A i a ee ee ee re re rn re eR Ce NE A a AE ra er | 


How Do You Like This Manual? Check those that apply. 


al 


es Somewhat No 


Is the manual easy to read (print size, page layout, and so on)? 
Is it easy to understand? 

Is the order of topics logical? 

Are there enough examples? 

Are the examples helpful? ( Too simple Too complex) 

Is the technical information accurate? — 

Can you easily find what you want? 

Do the illustrations help you? 

Does the manual tell you what you need to know about the topic? 


PEPE T EL 


Comments? If applicable, note page number and paragraph. 


Would you like a reply? ___ Yes No Continue on other side 


From: 


Name _ Company 


Address Date _ 


Men ee ee ae a ee are ate he le eth 


Phone No. 


A A A A a a ee 


—_—— a a ee ee ee ae re ae a ee ee 


— 


Please send program listing and output if applicable to your comment. 
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